=== SISL Product Options ===
Contributors: sislsource
Tags: woocommerce, product options, product addons, extra product options, custom fields
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Custom options and extra fields for WooCommerce products, with optional add-on pricing that updates live. HPOS & Blocks-checkout ready.

== Description ==

**SISL Product Options** lets you add custom fields and options to any WooCommerce product: a text line for engraving, a dropdown for size, checkboxes for extras, a number field, and more. Each option can carry its own price, and the total updates live on the product page as the customer chooses.

Every selection is validated, carried into the cart at the right price, and stored on the order - visible in the cart, at checkout, in the order emails and in the admin. Built for the modern WooCommerce stack: **High-Performance Order Storage (HPOS)** and the **Blocks checkout**.

= Free features =

* **Seven field types** - text, text area, number, dropdown, radio buttons, checkboxes, and a heading/note for grouping options.
* **Optional add-on pricing** - give any choice (or a filled-in field) a price and it is added to the product price automatically.
* **Live price preview** - the customer sees the options total and the new price update as they choose, right on the product page.
* **Required fields** - mark any option as required; the product cannot be added to the cart until it is filled in.
* **Cart, checkout & order** - chosen options and their prices show in the cart, in the classic and Blocks checkout, in the order emails and on the admin order screen.
* **Priced on the server** - add-on prices are always taken from the product's saved options, never from the submitted form, so totals cannot be tampered with.
* **HPOS & Blocks-ready** - options are stored as native order-item data and work with the block-based cart and checkout.
* **Translation ready** - English source strings.

= On the roadmap =

Conditional logic (show a field only when another option is chosen), per-quantity and percentage pricing, min/max limits and more field types are in development.

= About =

SISL Product Options is built and maintained by [SISL](https://sisl.pl), an independent studio building WooCommerce and Magento tools. Questions and feature requests are welcome.

== Installation ==

1. Upload the plugin to `/wp-content/plugins/` or install it from **Plugins > Add New**.
2. Activate it. WooCommerce must be active.
3. Edit any product and open the **Product Options** tab in the product data panel.
4. Add your options. Give an option a price to add it to the product price when the customer chooses it.

== Frequently Asked Questions ==

= Does it work with HPOS and the Blocks checkout? =

Yes. Options are stored as native order-item data, and the chosen values and prices show inside the Blocks checkout as well as the classic one.

= Can an option add to the price? =

Yes. Each choice in a dropdown, radio or checkbox field can have its own price, and text or number fields can carry a flat price that applies when they are filled in. The product price updates live as the customer chooses.

= Are the prices safe from tampering? =

Yes. The add-on price is always read from the product's saved options on the server, so a modified form value cannot change what the customer is charged.

= Can I make an option required? =

Yes. Any field can be marked required, and the product cannot be added to the cart until it is filled in.

= Where can I get support? =

Use the plugin's support forum here on WordPress.org, or contact the developers directly at [sisl.pl](https://sisl.pl).

== Screenshots ==

1. The Product Options tab - building options on a product.
2. Options on the product page with the live price preview.
3. Chosen options shown in the cart.

== Changelog ==

= 0.1.0 =
* First release: seven field types, optional add-on pricing, live price preview, required fields, cart / checkout / order display, HPOS and Blocks-checkout support.

== Upgrade Notice ==

= 0.1.0 =
First release of SISL Product Options.
