=== ShelfBuilder Lite ===
Contributors: jkolodziej
Tags: grid, block, drag-drop, layout, gallery
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A visual grid block with drag-and-drop ordering. Hand-pick posts and pages, then arrange them like items on a shelf.

== Description ==

ShelfBuilder Lite is a Gutenberg block plugin that lets you create curated, hand-picked grids with full drag-and-drop ordering. Unlike query-based blocks that automatically pull content, ShelfBuilder gives you complete control over which items appear and in what order.

**How it works:**

1. Add the ShelfBuilder block to any page or post
2. Choose a content type (Posts, Pages, or custom post types)
3. Pick specific items from a searchable, scrollable list
4. Drag and drop to arrange them in your preferred order
5. Customize the grid layout with sidebar controls

**Features:**

* Drag-and-drop grid ordering with visual gap indicators
* Searchable item picker with tag filtering
* Customizable columns (1-6), gap spacing, and card max width
* Image aspect ratio options (square, landscape, wide, portrait)
* Text alignment controls (left, center, right)
* Grid padding for centered layouts
* Responsive design (2 columns on tablet, 1 on mobile)
* Lightweight — no jQuery dependency, minimal CSS, zero frontend JavaScript

**Looking for WooCommerce support?**

[ShelfBuilder Pro](https://pixelsandpetals.net/product/shelfbuilder-pro) adds WooCommerce products, product categories, product tags, pricing display, item counts, add-to-cart buttons, hierarchical category browsing, and product tag filtering — all for a one-time $1 purchase.

== Installation ==

1. Upload the `shelfbuilder-lite` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Add the "ShelfBuilder Lite" block to any page or post using the block editor

== Frequently Asked Questions ==

= Does this work with the block editor only? =

Yes, ShelfBuilder is a Gutenberg block. It requires WordPress 6.0 or later with the block editor enabled.

= Can I use this with WooCommerce products? =

The Lite version supports Posts, Pages, and non-WooCommerce custom post types. For WooCommerce product grids, product categories, pricing, and add-to-cart buttons, check out [ShelfBuilder Pro](https://pixelsandpetals.net/product/shelfbuilder-pro).

= How many items can I add to a grid? =

There is no hard limit. The item picker loads up to 200 items per content type, and you can select as many as you need.

= Does this add any scripts to my frontend? =

No. ShelfBuilder renders pure HTML and CSS on the frontend with zero JavaScript. The drag-and-drop editor interface only loads in the block editor.

= Can I have multiple ShelfBuilder blocks on one page? =

Yes, each block is independent with its own content type, item selection, and layout settings.

== Screenshots ==

1. The drag-and-drop grid editor with visual reordering
2. Sidebar controls for content source and item selection
3. Grid settings with columns, gap, padding, and card width options
4. A rendered grid on the frontend

== Changelog ==

= 1.0.0 =
* Initial release
* Drag-and-drop grid block with pointer-event-based reordering
* Searchable item picker with tag filtering
* Support for Posts, Pages, and custom post types
* Customizable columns, gap, aspect ratio, text alignment
* Grid padding and card max width controls
* Responsive frontend layout
* Vertical gap indicator during drag operations

== Upgrade Notice ==

= 1.0.0 =
Initial release of ShelfBuilder Lite.
