=== ClassicAddons Content Blocks ===
Contributors: classicaddons
Tags: blocks, hero, faq, comparison, gutenberg
Requires at least: 6.4
Tested up to: 7.0
Stable tag: 1.1
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A premium, professional block library for the WordPress block editor.

== Description ==

**ClassicAddons Content Blocks for Gutenberg Editor** brings premium quality elements to your WordPress site. Built with modern Gutenberg APIs, full PHP 8+ compatibility, and extensible architecture for upcoming block packs.

Currently includes:

* **Classic Section** — a full-width container/row with background (color / gradient / image / overlay) and an adjustable inner content max-width. Drop columns, info boxes or any blocks inside.
* **Classic Hero Section** — a fully customizable hero with pill, gradient heading, two CTAs, animated proof bar and a browser-mockup image.
* **Classic Eyebrow** — a small pill/label for section headers: alignment, optional link, icon, colors, background, border and typography.
* **Classic Versus Box** — head-to-head two-card layout with optional "VS" badge, custom item icons and ribbon badges. Composable: drop it inside a Classic Section with your own heading.
* **Classic Comparison Table** — feature-by-feature comparison with highlighted column, good/bad/meh status pills, optional in-card header and footnote. Composable.
* **Classic Info Box** — feature card with icon (dashicon / image / emoji / custom SVG), customizable title, description, optional link, and 5 style variations.
* **Classic FAQ** — accessible accordion (native details/summary) with optional FAQPage JSON-LD schema for SEO. Renders the list only — compose the heading with the Eyebrow / Heading / Paragraph blocks.
* **Classic Pricing Box** — a single pricing plan card (name, price, features, badge, featured style) with a flexible CTA — a link or a JS button with custom id, classes and data-attributes (works with Paddle.js and similar). Stretches to equal height; drop several into a Columns/Grid layout.

Highlights:

* Dynamic PHP rendering via render callback (lean, cached, secure).
* Full responsive controls (desktop / tablet / mobile) for typography, padding and visibility.
* SEO-friendly heading tag selectors (H1 through H6, div) and optional FAQ schema (JSON-LD).
* Block style variations for the Hero, Section, Versus, Comparison, Info Box and FAQ blocks.
* Reusable controls — typography, spacing, color, gradient, icon picker, responsive helper.
* WordPress Coding Standards, full escaping/sanitization, i18n-ready.
* Accessibility: semantic HTML, ARIA labels, reduced-motion support, keyboard-friendly controls.
* Editor-only assets separated from frontend assets — only loads on pages that use the block.
* Built with `@wordpress/scripts`, ES Next, functional React components.

== Installation ==

1. Upload the `classicaddons-content-blocks` directory to your `/wp-content/plugins/` directory.
2. Run `npm install && npm run build` inside the plugin directory (only required if installing from source).
3. Activate the plugin through the 'Plugins' menu in WordPress.
4. Open any page/post in the block editor and search for "Classic Hero Section".

== Source Code & Build Process ==

This plugin is fully open source (GPL-2.0-or-later). The complete, human-readable
source for every compiled asset is bundled inside the plugin in the `/src`
directory. The minified files in `/build` are generated from `/src` using the
official `@wordpress/scripts` toolchain (webpack under the hood) — no other build
tools are required.

To regenerate the compiled assets from source:

1. `npm install` — installs the build dependencies declared in `package.json`.
2. `npm run build` — compiles `/src` into `/build`.

Use `npm start` for a watched development build. There is no obfuscation; the
build step only bundles and minifies the JavaScript and SCSS that ships in `/src`.

== Frequently Asked Questions ==

= Is this compatible with Full Site Editing (FSE) and block themes? =
Yes. The block uses `block.json`, the Block Supports API and standard WordPress hooks.

= Can I change the heading tag for SEO? =
Yes — the heading tag is selectable in the Content tab (H1 through H6 or div).

= Does it ship a frontend JS bundle? =
No. The block renders fully on the server; no jQuery and no frontend JavaScript are loaded.

== Screenshots ==

1. Live editor preview with inline editing.
2. Inspector tabs: Content, Style, Advanced.
3. Rendering: Info Box
4. Rendering: Pricing Box
5. Rendering: Comparison Table

== Changelog ==

= 1.1 =
* Initial release with seven blocks: Classic Section, Classic Hero Section, Classic Eyebrow, Classic Versus Box, Classic Comparison Table, Classic Info Box and Classic FAQ.
* Reusable component library (typography, spacing, responsive, color, gradient, icon picker).
* Block style variations across the Hero, Section, Versus, Comparison, Info Box and FAQ blocks.
* Optional FAQPage (JSON-LD) structured data on the FAQ block.
* PHP 8+ namespaced architecture, autoloader, extensible block registry.
