=== HS Product Options & Add-Ons for WooCommerce ===
Contributors: marcodevilio
Tags: woocommerce, product options, customization
Requires at least: 6.8
Tested up to: 7.1
Requires PHP: 8.2
Requires Plugins: woocommerce
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add text, number, checkbox, radio and select options to matching products and variations.

== Description ==

Add text, number, checkbox, radio and select options to matching products and variations.

Configuration is saved explicitly. New and imported groups remain disabled until reviewed and enabled. Prices and required options are validated on the server. The package contains English source strings and Italian translations.

Version 1.0.0 is the first supported HookSpark release. Compatibility claims remain limited to the environments and integrations documented on hookspark.dev.

== Installation ==

1. Use a backed-up local or staging WordPress installation with WooCommerce active.
2. Upload this ZIP through Plugins > Add New > Upload Plugin and activate it.
3. Open HookSpark > Product Options & Add-Ons.
4. Configure a disabled test group, save, inspect the preview, then enable and save.

== Frequently Asked Questions ==

= Can I use the Free plugin on a live store? =

Yes. Test your product rules, theme and checkout in staging first, then keep a current backup before updating a live store.

= Will deactivation delete configuration? =

No destructive uninstall routine is included. Keep a database backup before testing upgrades, downgrades or removal. Removing required Pro providers can prevent purchases using their fields; the full recovery workflow remains under test.

== Changelog ==

= 1.0.4 =
* 2026-10-10: Updated the packaged compatibility documentation after the 9–10 October checks. Selected paths checked with Elementor Free 4.3.4 and Pro 4.3.1, WordPress 7.1.3, WooCommerce 11.1.0 and PHP 8.2.29. Free and Pro option groups, conditional required fields and extras were checked in the Pro Single Product Add to Cart widget. Free options were also checked with Elementor Free Shortcode; native Cart/Checkout journeys retained selected options and amounts. Uploads, dynamic widget insertion and every variation/field combination remain store-specific checks. Labels do not translate automatically. Details: https://hookspark.dev/product-options/#compatibility


= 1.0.3 =
* Add optional WordPress Abilities/MCP access: read supported configuration and prepare validated proposals for same-user browser approval.
* Reuse one HookSpark AI access switch and review screen across installed plugins.
* Configuration changes are saved only after human approval; proposals expire after 15 minutes.

= 1.0.2 =
* 2026-10-06: Documented selected Astra and WPML/WCML compatibility checks. See the compatibility notes at https://hookspark.dev/product-options/#compatibility. Scope is limited to the recorded versions and scenarios; no universal compatibility certification. This package update documents testing and preserves the functional fixes listed in earlier entries.


= 1.0.1 =
* Fix: Product, variation, category and tag targets also match their WPML translations; exclusions keep priority.
* Fix: Invalid or missing product options return a controlled Store API validation error (HTTP 400) instead of HTTP 500.
* Pro uses the shared validation and targeting adapter in Free; update both editions together.

= 1.0.0 =
* First supported release of Product Options Free.
* Style the selected Product Options photo in the classic checkout review.
* Preserve server-side validation, pricing snapshots and customer selections across cart, checkout and orders.

= 0.1.0-alpha.20 — unreleased candidate =
* Add collapsible option groups that preserve entered values and reopen automatically when a required field is invalid.
* Let merchants choose a defined panel, theme-minimal or soft-background group style.
* Add an optional local group image while retaining an accessible fieldset name.
* Not published. Canonical integration and protected staging remain pending.

= 0.1.0-alpha.19 =
* Keep Pro-only field types visible in the admin picker with clear labels and disabled controls.
* Preserve legacy modal settings and show supported fields inline when the Pro add-on is absent.
* Support per-choice economic snapshots, authoritative line quotes and isolated cart-product image adapters for add-ons.
* Improve Italian labels and field-addressed errors in the configuration editor.

= 0.1.0-alpha.18 =
* Readable option-cost rows in Classic and Blocks cart/checkout, including narrow screens.
* Detailed option costs across cart, checkout and order emails with immutable purchase snapshots.
* Verified independent configurations and mixed validation in Store API batch.

= 0.1.0-alpha.16 =
* Preserve pending private uploads when a customer signs in from another guest session. Purchased files retain their original ownership.

= 0.1.0-alpha.15 =
* Preserve private uploaded files when a guest signs in before adding the configured product to the cart.

= 0.1.0-alpha.14 =
* Align admin inputs with the rounded HookSpark controls and keep Save changes available while scrolling.

= 0.1.0-alpha.13 =
* Keep keyboard focus on the moved option field after reordering; focus its heading at the list boundary.

= 0.1.0-alpha.12 =
* Load configurator assets for WooCommerce product_page shortcodes in pages and Elementor Free Shortcode widgets.

= 0.1.0-alpha.11 =
* Refresh the server-rendered mini-cart badge when the Blocks data store is not loaded.

= 0.1.0-alpha.10 =
* Refresh the Blocks cart count after modal additions without opening its drawer.

= 0.1.0-alpha.9 =
* Keep the styled configurator visible during native cart submission; confirm success without a page repaint.

= 0.1.0-alpha.8 =
* Included choices and priced checkbox extras use consistent cost labels.
* Modal steps include a final review before native cart submission.

= 0.1.0-alpha.7 =
* Ask whether to configure another product or view the cart after a successful modal purchase.
* Closed native disclosure prevents modal image flashes and supports browsing without JavaScript.

= 0.1.0-alpha.6 =
* Single-group simple-product modals include native quantity, price summary and Add to cart; only the configurator trigger remains outside.

= 0.1.0-alpha.5 =
* Uniform ingredient images and consistent choice widths in modal presentation.

= 0.1.0-alpha.4 =
* Optional modal presentation with a custom group button, native keyboard behavior and inline fallback.
* Optional checkbox images; visual ingredient choices in the burger demo.

= 0.1.0-alpha.1 =

* Shared admin confirmation for unsaved changes, with visible recovery and consistent exit behavior across HookSpark plugins.
* Fix unintended draft creation when opening the general editor; clarify unsaved changes and upload errors.
* Align admin tabs, catalog, controls and responsive layout with the shared HookSpark Core.
* Initial local development candidate. Source-level evidence and outstanding acceptance are maintained in the project documentation.
