Changelog

• Added
• Q&A admin tab for curated question/answer pairs. New wp_alpha_chat_faqs table, REST CRUD at /faqs, and context-injection into every chat request.
• Source links now carry UTM parameters (utm_source=alpha_chat, utm_medium=chat_widget, utm_campaign=ai_answer, utm_referrer={host}).
• Changed
• Brand identity is prepended to the system prompt on every request. "Who are you?" and similar prompts now resolve without needing RAG context.
• Retrieval gate widened: LLM is called when either chunks OR FAQs are available; fallback only when both are empty.
• System prompt now explicitly tells the LLM not to emit bracketed citation markers — frontend strips any that slip through.
• Fixed
• Identity-style questions returning fallback even with an indexed site.

• Added
• Indexer::index_post now stores a SHA-256 content hash + embedding model per post and skips re-embedding when nothing has changed. Makes "Reindex all" idempotent and cheap.
• New GET /knowledge-base/queue endpoint returning pending / in_progress / complete / failed counts for the alpha-chat Action Scheduler group.
• New POST /knowledge-base/queue endpoint runs one Action Scheduler batch synchronously (useful when DISABLE_WP_CRON is set).
• Dashboard shows live indexing queue counts with auto-refresh every 5s while work is in flight, plus a one-click "Process now" button.
• Knowledge Base toolbar gains a "Process queue now" button.
• Fixed
• Chat panel close button was invisible on mobile — SVG had no explicit size inside the shadow DOM's all: initial root. Added a global svg rule + sized close icon; close is now a circular button in the header top-right.
• Re-queued bulk jobs no longer re-embed already-indexed content (hash guard).
• Changed
• Removed :host reset for all SVGs globally, ensuring any icon placed in the widget renders at its CSS size.

• Initial public release.
• OpenAI (GPT-5.4 / GPT-5.4 mini / GPT-4.1) and Anthropic (Claude Opus 4.7 / Sonnet 4.6 / Haiku 4.5) chat providers.
• MySQL-backed vector store with cosine similarity.
• Shadow-DOM-isolated React widget.
• Gutenberg block and [alpha_chat] shortcode; floating launcher is opt-in.
• Customizable launcher position, nudge text, brand name, and color scheme.
• Source cards (title + thumbnail) attached to each reply.
• In-chat contact form (Name + Email + Message) with admin email notifications and Contacts admin tab.
• Knowledge Base batch actions: select rows, bulk index / remove, "Index remaining", filter by indexed state.
• All public post types indexable (filter via alpha_chat_indexable_post_types).
• Token-frugal: empty retrievals skip the LLM entirely.
• Rate limiting on chat (30/min per session) and contact (5/hour per IP).

Supported: tags, .class, #id, [attr="val"], {text}, > child, + sibling, *N multiply, \$ numbering. Cursor auto-jumps to the first empty slot.

Removed: Unreliable HTML class autocomplete (replaced by Emmet).

• Emmet HTML Expansion (NEW): Type an abbreviation in the HTML editor, press Tab, get expanded HTML: - div.hero>h1{Title}+p{Body} → nested section with heading and paragraph - ul.menu>li.item\$*4>a[href="#"]{Link} → 4-item menu with auto-numbered classes - img.avatar[alt=""] → self-closing void tag
• Frontend CSS Layers (NEW): Three independent toggles under Page Blocks → Settings → Frontend CSS:
• Semantic Reset (~1KB) — modern reset, accessible images, prefers-reduced-motion
• Typography (~3KB) — system-font stack (zero external requests), responsive headings via clamp(), 65ch measure, styled lists / blockquotes / code / kbd / tables
• Utility Classes — ~330 Tailwind-inspired classes (grid, flex, spacing, typography, colors, borders, shadows, transitions) + sm: md: lg: responsive variants. Frontend inlines ONLY the classes actually used on the page — no bloat. Builder loads the full set for autocomplete.
• Top-Level Page Blocks Admin (NEW): Moved out of Settings to its own top-level menu: - All Page Blocks — list table with bulk actions, search, status filter - Add New — full edit form with Monaco editors, live preview, position picker - Settings — existing settings page - License — license management
• Shortcode Library (NEW): Reusable blocks stored in a custom database table (wp_gt_page_blocks): - [page_block id="123"] — embed by ID - [page_block slug="hero-section"] — embed by slug - Theme-independent position hooks via gt_pb_get_positions() filter (wp_head, wp_footer, the_content, loop_start, etc.)
• Bug Fixes
• Fixed cssClasses config being serialized as JSON object (array_unique key gaps) — Array.isArray() now passes on the JS side.
• Compatibility
• WordPress 6.0+
• PHP 8.1+
• Works with any WordPress theme
• PHPStan level 5: 0 errors

• Critical fix for v2.0.0/v2.0.1. The builder was stuck on "Loading Page Blocks Builder..." with no errors. Root cause: the v2.0.0 release ported the dropin's JS which expects the app element ID md-pb-builder-app, but the template HTML still used the old ID md-page-block-builder-app. The JS bailed out silently at the missing-element check.
• Fix
• templates/builder-shell.php: Updated app element ID to md-pb-builder-app
• Updated wrapper class to md-pb-builder-root and loading class to md-pb-builder-loading to match the new CSS naming
• Upgrading from v2.0.x: Just update — clear browser cache to reload the new template.

• Fixes
• Fix block_categories_all filter signature mismatch (callback registered with accepted_args=2 but only declares 1 parameter)
• Fix esc_attr() type errors when emitting external asset tags — cast int post_id and int|false filemtime result to string before passing
• Properly escape stylesheet id attribute in external file output
• Remove redundant is_array() / is_string() checks against already-narrowed types
• Verification
• PHPStan level 5 passes with 0 errors on the entire plugin
• All previously broken features verified working

• Major Features
• AI Chat Sidebar — Multi-turn conversation replaces the inline AI bar. Persistent context, "+ New Chat" button, message history. OpenAI, Anthropic, Gemini supported. Theme CSS variables sent as system prompt context.
• Inline Text Editing in Preview — Click any heading, paragraph, link, or list item directly in the preview iframe to edit. Enter commits, Escape cancels.
• Live Preview Patching — No more flicker on every keystroke. CSS/content edits patch iframe DOM in place; only structural changes trigger full reload.
• HTML Snippet Buttons — Quick-insert buttons on the HTML editor title bar: sec, div, h1-h3, p, a, img, ul, ol, span, b, i. Wraps selection or inserts empty.
• Section Renaming — Double-click any section name in the sidebar to rename it inline.
• SVG Icons — Replaces unicode glyphs for hide/duplicate/delete buttons.
• Keyboard Shortcuts Overlay — ? button shows all shortcuts.
• Export/Import — Download/upload sections as JSON, append or replace modes.
• Settings
• Preview Customization — New admin fields for custom CSS, head HTML, and footer JS injected into the preview iframe. No PHP filter needed for common cases.
• AI default model changed from gpt-5.2 to claude-sonnet-4-6.
• Fixes
• Script injection in preview iframe: Now injected post-load via contentDocument.createElement('script') instead of inline <script> in srcdoc. Fixes SyntaxError: Unexpected token '<' errors caused by </script> parsing in srcdoc HTML.
• SVG icon click delegation: Uses closest('[data-action]') to traverse up from clicked SVG to the button.
• HTTPS enforcement: All preview style URLs forced to https:// to eliminate mixed content warnings.
• AI conversation history: All three providers (OpenAI, Anthropic, Gemini) properly send the message array.
• Removed
• Terminal feature (was beta) — removed for production safety.
• Compatibility
• WordPress 6.0+
• PHP 8.1+
• Works with any WordPress theme (no theme dependencies)

• What's Changed
• Commits
• Fix post-display CSS regression: static flag with ID-scoped selectors (33406be)
• Bump version to 2.7.1 (177d966)
• Fix code quality, dark mode, performance, and extensibility across plugin (af92331)
• Fix accessibility, dark mode, performance, and security issues (c8aca43)
• Stats
• Commits: 4
• Changes 30 files changed, 241 insertions(+), 103 deletions(-)
• Plugin Info
• Blocks included: 29
• Requires WordPress: 6.0+
• Requires PHP: 7.4+
• Requires: ACF Pro 6.0+ or Secure Custom Fields
• Installation
• Download acf-blocks-plugin-*.zip from the assets below
• Go to Plugins → Add New → Upload Plugin in WordPress admin
• Upload the zip file and activate

• What's Changed
• Commits
• Bump version to 2.7.0 (63e5c10)
• Improve product box design: fix font-size bug, checkmark bullets, two-column features, horizontal bottom layout, clickable image (ca67938)
• Fix product box layout when features list is taller than image (f92566d)
• Stats
• Commits: 3
• Changes 3 files changed, 14 insertions(+), 7 deletions(-)
• Plugin Info
• Blocks included: 29
• Requires WordPress: 6.0+
• Requires PHP: 7.4+
• Requires: ACF Pro 6.0+ or Secure Custom Fields
• Installation
• Download acf-blocks-plugin-*.zip from the assets below
• Go to Plugins → Add New → Upload Plugin in WordPress admin
• Upload the zip file and activate

• What's Changed
• Changed
• All blocks: Every ACF field is now optional. Removed required: 1 flags and min: 1 constraints on repeaters/relationships so any block can be inserted without being forced to fill specific fields.
• Removed
• Chat block: Completely removed the acf/chat-block and its directory (blocks/chat-block/).
• Improved
• LLM prompt library (llm/): Added llm/README.md as an index covering all 29 blocks grouped by category, universal rules (single-line JSON, field-key prefix, repeater format, InnerBlocks vs ACF data), and a block-comment anatomy reference. Removed stale "Required" annotations from nine per-block docs now that no fields are required.
• Commits
• Bump version to 2.6.0 (1fe9e20)
• Improve LLM prompt library (af0a5b7)
• Remove Chat block (11465d2)
• Make all block fields optional (32dda06)
• Stats
• Commits: 4
• Changes 26 files changed, 153 insertions(+), 297 deletions(-)
• Plugin Info
• Blocks included: 29
• Requires WordPress: 6.0+
• Requires PHP: 7.4+
• Requires: ACF Pro 6.0+ or Secure Custom Fields
• Installation
• Download acf-blocks-plugin-*.zip from the assets below
• Go to Plugins → Add New → Upload Plugin in WordPress admin
• Upload the zip file and activate

= 1.4.4 = = 1.4.5 = Enables WOFF/WOFF2 font uploads in the media library with magic-byte validation for security.

• What's Changed
• Added WOFF and WOFF2 font file uploads now supported in the WordPress media library
• Security Font uploads validated via binary magic-byte signatures to prevent malicious file uploads
• Commits
• v1.4.5: allow WOFF/WOFF2 font uploads in WordPress media library (7e66ba1)
• fix suppress PHPCS warnings for uninstall meta_key query and dynamic hook name (d6ca5fb)

• What's Changed
• Fixed
• Product Review block: Fixed 4 Google Search Console structured data errors: missing price, hasMerchantReturnPolicy, shippingDetails in offers, and missing image fallback.
• Added
• Product Review block: New Product Type field — choose between Product (physical/generic) and SoftwareApplication (apps/SaaS) schema types. SoftwareApplication includes applicationCategory and operatingSystem fields.
• Product Review block: New Return Policy field with options: No Returns (digital), Finite Return Window (with configurable days), Unlimited Returns. Maps to hasMerchantReturnPolicy in offers schema.
• Product Review block: New Delivery Type field — Digital (instant/$0 shipping) or Physical. Digital products get zero-cost instant delivery in shippingDetails.
• Product Review block: New Shipping Country field (ISO country code) used for both shipping destination and return policy region.
• Product Review block: Image now falls back to post featured image when no product image is set, preventing GSC "Missing field image" errors.
• Product Review block: Offers schema is now always generated (price defaults to "0" when empty) to prevent GSC missing field warnings.
• Commits
• Fix GSC structured data errors and add schema options to Product Review block (37e9980)
• Stats
• Commits: 1
• Changes 4 files changed, 236 insertions(+), 23 deletions(-)
• Plugin Info
• Blocks included: 30
• Requires WordPress: 6.0+
• Requires PHP: 7.4+
• Requires: ACF Pro 6.0+ or Secure Custom Fields
• Installation
• Download acf-blocks-plugin-*.zip from the assets below
• Go to Plugins → Add New → Upload Plugin in WordPress admin
• Upload the zip file and activate