=== DisplayKit - Page, Post & Product Display Block ===

Contributors:      upluggit
Donate link:       https://profiles.wordpress.org/upluggit/
Tags:              post grid, product display, gutenberg block, woocommerce, post list
Tested up to:      6.9
Requires at least: 6.2
Requires PHP:      7.4
Stable tag:        1.0.0
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

A flexible block for displaying pages, posts, and WooCommerce products with grid and list layouts, rich customization, and dynamic querying.

== Description ==

DisplayKit allows WordPress users to display content from any post type — including pages, posts, and WooCommerce products — with powerful layout and styling options, all without writing a single line of code.

= Key Features =

* **Any Content Type** — Display Posts, Pages, WooCommerce Products, or any registered Custom Post Type.
* **Specific Item Selection** — Hand-pick individual posts or products to showcase by searching and selecting them in the editor.
* **Multiple Layouts** — Grid (1–6 columns) and List layouts with customizable card dimensions, alignment, and responsive breakpoints.
* **WooCommerce Integration** — Product price, sale badges, star ratings, stock status, and Add to Cart buttons are displayed automatically when showcasing products.
* **Post Card Customization** — Toggle featured images, titles, excerpts, author/date meta, and read-more buttons. Control image aspect ratios, typography, colors, spacing, and border radius.
* **Open in New Tab** — Optionally open all card links in a new browser tab.
* **Performance Optimized** — Skeleton loading states, lazy-loaded images, and smooth CSS transitions ensure great Core Web Vitals scores.
* **Mobile-First Design** — Layouts adapt beautifully to any screen size with responsive breakpoints.
* **Security** — All inputs are sanitized and outputs are properly escaped.

= Editor Experience =

Settings are organized into intuitive panels in the block sidebar:

* **Query Panel** — Post type, taxonomy, terms, author, order, count, specific posts/products selection
* **Layout Panel** — Grid/List, columns, gaps, card dimensions, alignment
* **Display Panel** — Toggle post card elements, open in new tab, image aspect ratio
* **WooCommerce Panel** — Price, rating, sale badge, add to cart controls (appears when product post type is selected)
* **Style Panel** — Colors, typography, spacing, border radius

= Third-Party Services =

This plugin does not connect to any third-party or external services. All data is queried and rendered locally from your WordPress installation using the WordPress REST API.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/displaykit` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. In the block editor, search for "DisplayKit" and add it to your page.

== Frequently Asked Questions ==

= Does it work with Custom Post Types? =

Yes! The block dynamically fetches all public post types registered on your site.

= Does it work with WooCommerce? =

Yes! Select the "Products" post type and DisplayKit will automatically show product-specific information like price, ratings, sale badges, and an Add to Cart button. WooCommerce must be installed and activated separately.

= Can I sort products by price, popularity, or rating? =

Yes! When the Products post type is selected with WooCommerce active, additional "Order By" options appear: Price, Popularity, Rating, etc.

= Can I display specific posts or products? =

Yes! Use the "Specific Posts/Products" control in the Query panel to search and hand-pick individual items to display.

= What are the minimum requirements? =

WordPress 6.2 or higher and PHP 7.4 or higher. For WooCommerce product features, WooCommerce must be installed and active.

== Screenshots ==

1. DisplayKit block in the Gutenberg Block editor.
2. Grid layout with customizable card dimensions and alignment.
3. List layout with customizable card dimensions and alignment.

== Changelog ==

= 1.0.0 =
* Initial release with page/post/product display, multiple layouts, WooCommerce integration, and rich customization.

== Upgrade Notice ==

= 1.0.0 =
First release.