=== Optionline – product options for WooCommerce ===
Contributors: afkzonagroup
Tags: product options, product add-ons, extra options, custom fields, woocommerce
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Customers choose extras, sizes, text and quantities before adding a product to the cart, and every choice is priced exactly and kept on the order.

== Description ==

Optionline adds an "Options" tab to simple and variable products. Each field you add appears on the product page above the add-to-cart button.

= Fields =

* Short and long text, for example an engraving or a note, with a maximum length
* Numbers with a minimum and maximum, priced per unit: "extra cable, €2 per metre"
* A tick box: "gift wrap (+€3)"
* One choice as buttons or as a list, or several choices at once, each choice with its own price
* Required or optional, with a help text under the field

= Shown only when it applies =

Show a field only when an earlier choice is made: the engraving text only when "Engraving" is ticked, the frame colour only when "With frame" is chosen. Hidden fields are not sent, not required and not charged; the shop checks the same rule again when the product is added to the cart.

= Prices you can trust =

* Option prices are added to the product's price per item, or charged once per order line, for example a set-up fee that does not grow with the quantity
* The product page shows a running total; the cart charges exactly that
* Prices follow your shop's VAT settings, like product prices
* Every choice is checked on the server: a changed page cannot buy a choice that is not offered or skip a required field

= On the order =

The choices appear under the product in the cart, at checkout, in the order emails, in My account and on the order screen, as they were when the customer ordered.

Works with the block cart and checkout and the classic ones, with block themes and classic themes, and with WooCommerce's order storage (HPOS).

== Installation ==

1. Install and activate WooCommerce and Optionline.
2. Edit a product and open the "Options" tab in Product data.
3. Add a field, choose its type, and enter its choices one per line, with a price after a | sign: "Large | 5".

== Frequently Asked Questions ==

= Do variable products work? =

Yes. The fields apply to every variation, and the running total follows the variation the customer picks.

= What happens to old orders when I change a product's options? =

Nothing. Orders keep the choices as they were bought.

= What happens when I delete the plugin? =

Orders keep their choices. The fields stay saved on your products, so they come back if you install Optionline again.

== Changelog ==

= 1.0.0 =
* First release.
