=== Addovio Product Add-ons ===
Contributors: gustamarsas
Tags: product addons, product options, woocommerce addons, food ordering, product customization
Requires at least: 5.8
Requires PHP: 7.4
Tested up to: 7.1
Stable tag: 1.6.29
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add product extras, add-ons, and custom options to WooCommerce products with flexible selection rules.

== Description ==

**Addovio Product Add-ons** lets customers customize WooCommerce products with extra options before adding them to the cart.

Create reusable groups of product options, set additional prices, and control how many options customers can select. It is ideal for restaurants, food delivery stores, personalized products, accessories, and other WooCommerce stores that offer additional choices.

### Example

Sell a burger and let customers choose:

* Cheese +$2.00
* Bacon +$3.00
* Mushrooms +$2.00
* Extra sauce +$1.00

Customers can select their options directly on the product page before adding the product to the cart.

You can configure each group as single-choice or multiple-choice and set minimum and maximum selection limits.

### Features

* **Product customization** – add extra options directly to WooCommerce product pages.
* **Product add-ons with pricing** – give each option its own additional price.
* **Reusable option groups** – create groups once and assign them to multiple products.
* **Flexible selection rules** – configure single-choice or multiple-choice groups with minimum and maximum selections.
* **Required selections** – use minimum selection limits to require customers to choose an option.
* **WooCommerce integration** – selected extras are carried through the cart and order.
* **Simple management** – manage reusable product extras from a central screen.
* **Responsive interface** – provide customers with a mobile-friendly product customization experience.
* **Brand color customization** – set a global color for active add-on selectors across groups and options.
* **Add-on images** – display visual images for options on the single product page.
* **Live price summary** – show the base price, selected add-ons, and current total on the single product page.

### Free Features

* Create unlimited reusable product add-on groups
* Add product options and add-ons to WooCommerce products
* Set an additional price for each option
* Single-choice and multiple-choice groups
* Minimum and maximum selection limits
* Required selections using minimum limits
* Assign groups directly to WooCommerce products
* Reuse the same group on multiple products
* Manage reusable groups from a central screen
* Carry selected extras into the WooCommerce cart and order
* Responsive customer-facing interface
* English-first interface for international stores
* Global brand color for active selectors
* Add-on images on the single product page
* Live price summary on the single product page

### Use Cases

**Restaurants and food delivery**

* Add toppings
* Choose side dishes
* Select sauces
* Add drinks
* Customize meals
* Customize pizzas
* Customize burgers
* Customize desserts

**Personalized products**

* Add accessories
* Offer paid customizations
* Let customers choose additional product options
* Add optional extras to products

**Other WooCommerce stores**

Addovio Product Add-ons can be used whenever customers need to make additional choices before purchasing a product.

For example, you can use product extras for gifts, accessories, personalized items, bundles, services, and other products that require additional selections.

### Addovio Product Add-ons Pro

The optional **Addovio Product Add-ons Pro** add-on extends the free plugin with advanced product option and management features.

Pro adds:

* Product and category targeting
* Product and category exclusions
* Linked products
* **Individual add-on availability controls** – temporarily pause specific extras when an ingredient or add-on is unavailable, without disabling the entire product.
* Reusable note fields
* Advanced ordering controls
* Additional configuration options

The Pro add-on requires Addovio Product Add-ons to be installed and activated.

== Installation ==

1. Install and activate WooCommerce.
2. Install and activate Addovio Product Add-ons.
3. Go to **WooCommerce > Addovio Product Add-ons**.
4. Create an extra group.
5. Add your options and set their prices and selection rules.
6. Assign the group to one or more WooCommerce products.
7. Save the group.
8. Open the product on the frontend and test the available options.

For advanced features, install and activate **Addovio Product Add-ons Pro**.

== Frequently Asked Questions ==

= Is Addovio Product Add-ons free? =

Yes. The core plugin is free to use. An optional Pro add-on is available for advanced features.

= Does Addovio Product Add-ons require WooCommerce? =

Yes. WooCommerce must be installed and activated.

= Can I add a price to a product extra? =

Yes. Each option can have its own additional price.

= Can customers select multiple product options? =

Yes. You can create multiple-choice groups and define minimum and maximum selection limits.

= Can I make a product option required? =

Yes. Set a minimum selection limit to require customers to choose one or more options.

= Can I set a minimum and maximum number of selections? =

Yes. Each option group can have minimum and maximum selection limits.

= Can I reuse the same product extra group on multiple products? =

Yes. Extra groups are reusable and can be assigned to multiple WooCommerce products.

= Can I use Addovio Product Add-ons for a restaurant or food delivery store? =

Yes. The plugin works well for meals, pizzas, burgers, drinks, desserts, toppings, sauces, side dishes, and other products with customizable options.

= Can I use it for products outside of food and restaurants? =

Yes. Addovio Product Add-ons can be used for accessories, personalized products, gifts, bundles, and other WooCommerce products that need additional choices.

= Does the Free version support images for product extras? =

Yes. The Free version supports images for add-on options on the single product page.

= Does the Free version support product categories? =

The Free version assigns extra groups directly to WooCommerce products. Category-based targeting is available in the Pro add-on.

= What does the Pro add-on provide? =

The Pro add-on adds advanced product and category targeting, product and category exclusions, linked products, and individual add-on availability controls. You can temporarily pause a specific extra when an ingredient or add-on is unavailable without disabling the entire product, helping restaurants and food delivery stores keep the rest of their menu available. Pro also includes reusable note fields, advanced ordering controls, and additional management features.

= Does Pro replace the Free plugin? =

No. Pro is an add-on and requires Addovio Product Add-ons to remain installed and active.

== Screenshots ==

1. Create an add-on group with custom options and prices.
2. Assign an add-on group to specific products using checkboxes.
3. Manage your saved add-on groups.
4. Display add-on groups and extra prices on the product page.
5. Show selected add-ons in the cart.

== Changelog ==

= 1.6.29 =
* Added: Global brand color setting for active selectors, displayed above the Options section.
* Changed: Updated tags and clarified Pro's individual add-on pause feature in the readme.

= 1.6.28 =
* Update icon and fix bug.

= 1.6.27 =
* Fixed the container area..

= 1.6.26 =
* Fixed Update file field.


= 1.6.25 =
* Improved editor column sizing so the Assigned Products panel no longer stretches left-side sections.
* updated icon in admin panel.


= 1.6.24 =
* Added: Radio, Checkbox, Select, Text, Textarea, and Number field types for WooCommerce product options.
* Added: Custom field settings for required fields, placeholders, maximum text length, and number ranges.
* Added: Customer-entered text and numeric values now persist through the cart, checkout, and order.
* Added: Select fields can use the same option pricing system as radio and checkbox fields.
* Changed: Existing 1.6.x add-on groups remain backward compatible; groups without a field type continue to behave as before.

= 1.6.23 =
* Fixed: Restored starting-price display for products with two or more required add-on groups when the cheapest valid combination has a positive additional cost.
* Changed: Starting-price calculation now explicitly evaluates all required groups together and uses the cheapest valid combination across every required group.
* Fixed: Kept the base product price when the cheapest valid required combination costs R$ 0.00, including products with multiple required groups.
* Changed: Added the Image column heading above the Free add-on image controls in the Options editor.
* Changed: Refined the starting-price calculation for products with required add-on groups.
* Changed: Products with one required group now show a starting price only when the cheapest valid required selection adds a cost to the base product price.
* Changed: Products with two or more required groups show a starting price only when the cheapest valid required combination adds a cost to the base product price.
* Fixed: Prevented the "From" label from appearing when all required selections can be made at no additional cost.
* Added: Drag-and-drop reordering for saved add-on groups.
* Changed: Saved group order is stored and used when groups are displayed on WooCommerce products.
* Changed: Added a visual drag handle to the Saved Add-on Groups interface.
* Fixed: Prevented copied add-on groups from keeping the one-time copy nonce in the editor URL, which could cause an "expired link" error when editing and saving the copied group.
* Changed: Added a clean Post/Redirect/Get flow after copying and saving add-on groups.
* Changed: Copy now preserves the complete group configuration while leaving assigned products empty.
* Changed: Moved add-on image controls to the first position in the option editor.
* Fixed: Improved option row layout so the Remove action stays inside the container.
* Fixed: Updated the product-page price summary to react to add-on selections.
* Added: Added a Copy action to Saved Add-on Groups.

= 1.6.22 =
* Changed: Refined the add-on editor layout and option fields.
* Changed: Improved spacing and alignment across the add-on group interface.
* Changed: Updated screenshot descriptions in the plugin documentation.

= 1.6.21 =
* Changed: Improved the add-on editor layout with a full-height 50/50 column structure.
* Changed: Improved the organization of the Group Details, Selection, Options, and Assigned Products sections.
* Changed: Refined the editor layout for better use of available screen space.

= 1.6.20 =
* Changed: Introduced a major visual redesign of the Addovio Product Add-ons interface.
* Changed: Redesigned the add-on group creation and editing experience.
* Changed: Improved the organization of group details, selection rules, options, and assigned products.
* Changed: Added a cleaner and more modern administrative interface.

= 1.6.19 =
* Changed: Improved the add-on editor layout and visual styling.
* Changed: Refined Delete and Remove button styles.
* Changed: Improved spacing and alignment in the options editor.

= 1.6.18 =
* Changed: Refined the administrative interface and visual styling.

= 1.6.17 =
* Added: Add-on images are now available in the Free version.
* Added: Added a live price summary to the single product page.
* Changed: Improved the Free version product customization experience while keeping advanced availability and management features for Pro.


= 1.6.16 =
* Added: Introduced starting-price calculation using the cheapest valid combination of required add-on options.
* Changed: Established the initial rule for displaying a starting price based on required add-on groups.

= 1.6.15 =
* Changed: Translated remaining Free version interface text to English for consistent international presentation.
* Changed: Updated add-on labels in cart and order item data to use the Addovio Product Add-ons terminology.


= 1.6.14 =
* Changed: Updated the Freemius SDK integration to use the Addovio Product Add-ons Free and Pro slugs.


= 1.6.13 =
* Fixed: Prevented product add-on prices from being accumulated multiple times when WooCommerce recalculates cart totals.
* Changed: Updated remaining admin labels to use the Addovio Product Add-ons name.
* Changed: Updated Pro messaging to avoid implying that unlimited groups are a paid-only feature.

= 1.6.12 =
* Changed: Renamed the plugin to Addovio Product Add-ons.
* Changed: Removed the Free version's three-group limit so the core functionality is fully available without an artificial usage restriction.
* Fixed: Sanitized the data passed to the group sanitization filter instead of passing raw request data.
* Changed: Updated plugin documentation and WordPress.org metadata.


= 1.6.11 =

* Updated Freemius integration for the Addovio Product Add-ons product configuration.
* Updated WordPress.org metadata and documentation.
* Improved the Free/Pro add-on integration.

= 1.6.8 =

* Changed: Updated plugin metadata and WordPress.org compatibility information.
* Fixed: Improved input validation, nonce verification and output escaping.
* Changed: Renamed the public plugin name to comply with WooCommerce trademark guidelines.

= 1.6.7 =

* Changed: English is now the default plugin language for international distribution.
* Changed: Updated admin and frontend interface text.
* Changed: Updated plugin author information.
* Changed: Updated public readme documentation.

= 1.6.6 =

* Added: Freemius integration for the Addovio Product Add-ons product.
* Added: Free plan and add-on architecture support.
* Added: Core product extras management functionality.

== License ==

Addovio Product Add-ons is licensed under the GPLv2 or later.
