== CloudFold Lite - AI-Powered Media Organizer & Cloud Storage Offloader ==

Contributors:      tophive
Tags:              gallery, media library, lightbox, gutenberg, media organizer
Requires at least: 6.0
Tested up to:      7.0
Requires PHP:      8.0
Stable tag:        1.0.0
License:           GPL-2.0+
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Build responsive image galleries, organize uploads into folders, publish Gutenberg blocks, and use a fast zero-dependency lightbox.

== Description ==

CloudFold Lite helps WordPress site owners and editors create image galleries, organize the Media Library, and publish polished frontend gallery experiences without adding a heavy frontend dependency.

CloudFold is a TopHive product. CloudFold Lite is the official WordPress.org edition maintained by TopHive from the official CloudFold domain at https://cloudfold.io/.

The plugin focuses on practical media workflows:

* Create galleries from the WordPress admin.
* Publish galleries with the `[cloudfold_gallery id="123"]` shortcode.
* Insert galleries with Gutenberg blocks.
* Organize media into folders for faster editing workflows.
* Choose gallery layouts such as Masonry, Grid, and Justified.
* Use the built-in zero-dependency lightbox for responsive image viewing.
* Edit image metadata such as alt text, captions, descriptions, link targets, tags, and focal point.

= Gallery Layouts =

CloudFold Lite includes flexible layouts for common publishing needs:

* Masonry for mixed image heights.
* Grid for predictable equal tiles.
* Justified for balanced rows.

= Media Organization =

CloudFold Lite adds a folder-based media workflow to help editors group uploads, filter assets, and find images faster.

= Gutenberg Blocks =

Use CloudFold blocks inside the WordPress block editor to insert galleries and related media components with a native editing experience.

= Lightbox =

The frontend lightbox is built without jQuery and supports responsive image viewing, captions, keyboard navigation, and gallery controls.

= Privacy =

CloudFold Lite does not send site content, media metadata, visitor information, or usage data to a CloudFold-owned server.

The plugin uses standard WordPress admin requests and REST API routes on the same site to save galleries, folders, settings, and media metadata. No third-party service is required for the Lite features described here.

= Source Code and Build Tools =

The human-readable source for CloudFold Lite assets and build tooling is maintained publicly at https://cloudfold.io/source/.

The source location includes:

* Admin React source for `admin/dist/`
* Public gallery JavaScript source for `public/js/`
* Public CSS source for `public/css/`
* Build scripts
* Build configuration and package metadata

To regenerate the WordPress.org Lite package from source, install dependencies with `npm install`, then run `npm run build:wporg-lite`. The build command creates `release/cloudfold-lite.zip`.

The compiled admin assets are generated with React 18.2.0, React DOM 18.2.0, Lucide React 1.8.0, Radix UI React primitives 1.x/2.x, clsx 2.1.1, class-variance-authority 0.7.1, tailwind-merge 3.5.0, and Terser 5.46.2. Build tooling uses Vite 5.4.21, @vitejs/plugin-react 4.7.0, Tailwind CSS 3.4.17, PostCSS 8.4.49, Autoprefixer 10.4.20, esbuild 0.25.9, shx 0.3.4, and bestzip 2.2.0.

Third-party package source, version, and license metadata are provided by `package.json` and `package-lock.json` at the public source location. These packages are distributed under permissive open-source licenses such as MIT, ISC, BSD, or Apache-2.0 as declared by their upstream package metadata.

== Installation ==

1. Upload the `cloudfold-lite` folder to `/wp-content/plugins/`, or install the plugin from the WordPress Plugins screen.
2. Activate **CloudFold Lite - Gallery & Media Organizer**.
3. Open **CloudFold** in wp-admin.
4. Create a gallery from **CloudFold -> Galleries** or organize uploads from **CloudFold -> Media Library**.

== Usage ==

= Shortcode =

Use this shortcode in posts, pages, widgets, or supported builders:

`[cloudfold_gallery id="123"]`

Replace `123` with the gallery ID shown in the gallery editor.

= Gutenberg Block =

Open the block editor, insert a CloudFold gallery block, then select an existing gallery.

= Media Folders =

Open **CloudFold -> Media Library** or the Media Library folder tools, create folders, and organize uploads for faster filtering.

== Frequently Asked Questions ==

= Does CloudFold Lite require jQuery on the frontend? =

No. The gallery and lightbox runtime is designed to work without a jQuery dependency.

= Does CloudFold Lite call an external service? =

No. CloudFold Lite works locally inside WordPress for gallery creation, media organization, and frontend rendering.

= How do I publish a gallery? =

Create or edit a gallery from **CloudFold -> Galleries**, then copy the shortcode shown in the editor, such as `[cloudfold_gallery id="123"]`.

= Can I use CloudFold Lite with the block editor? =

Yes. CloudFold Lite includes Gutenberg blocks for gallery publishing workflows.

= What should I check if a gallery does not update? =

Save the gallery again, clear any page cache, and confirm the shortcode uses the correct gallery ID.

== Screenshots ==

1. CloudFold dashboard overview.
2. Gallery list and gallery editor.
3. Gallery layout settings.
4. Media Library folder organization.
5. Frontend gallery with lightbox.
6. Gutenberg gallery block.

== Support ==

For support, use the WordPress.org support forum for this plugin and include:

* WordPress version
* PHP version
* CloudFold Lite version
* Steps to reproduce
* Screenshots or error logs when available

== Changelog ==

= 1.0.0 =
* Initial WordPress.org Lite release.
* Gallery builder, media organizer, Gutenberg blocks, and zero-dependency lightbox.
