=== Comboflare Combo Discounts for WooCommerce ===
Contributors: asrsagar087
Tags: woocommerce, discounts, combo, mix and match, tiered pricing
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create flexible WooCommerce product combos with server-validated quantity tiers, variable products, and percentage or fixed discounts.

== Description ==

Comboflare helps WooCommerce store owners create mix-and-match product combos with tiered percentage or fixed discounts and display them anywhere with a shortcode.

Features include:

* Create multiple combo rules from WooCommerce admin.
* Select eligible products and product categories.
* Percentage or fixed discount tiers.
* Simple and variable product support.
* Server-side product, variation, eligibility, tier, and price validation.
* Independent combo groups in the cart.
* Combo item quantity protection.
* Product-level discount calculation for WooCommerce tax, coupon, checkout, and order totals.
* Combo information stored on order line items.
* High-Performance Order Storage (HPOS) compatibility declaration.
* Responsive combo builder.

After creating a rule, place the combo builder on a page with:

`[cmbflr_combo id="123"]`

Replace `123` with the combo rule ID.

== Installation ==

1. Upload the `comboflare-combo-discounts` folder to `/wp-content/plugins/`, or install the ZIP from Plugins > Add Plugin > Upload Plugin.
2. Activate WooCommerce.
3. Activate Comboflare Combo Discounts for WooCommerce.
4. Go to WooCommerce > Combo Discounts.
5. Create a rule, select products/categories, and configure at least one discount tier.
6. Add `[cmbflr_combo id="RULE_ID"]` to the page where the builder should appear.

== Frequently Asked Questions ==

= Does it support variable products? =

Yes. Customers select variation attributes in the combo builder and the server validates the matching WooCommerce variation before it is added to the cart.

= Can customers manipulate prices in JavaScript? =

Frontend prices are previews only. Eligible products, variations, tiers, and prices are recalculated on the server.

= Can a coupon be used with a combo? =

Yes. Combo discounts are applied to product prices before WooCommerce calculates eligible coupons. Normal WooCommerce coupon restrictions still apply.

= What happens if a customer removes a combo item? =

The combo group is recalculated. If it no longer reaches a configured tier, the combo discount is removed.

= Are combo rules deleted on uninstall? =

No. Combo rules are intentionally retained to avoid accidental store configuration loss. The plugin version option is removed.

== Privacy ==

Comboflare Combo Discounts for WooCommerce does not send plugin data to external services. Combo configuration is stored in the WordPress database, and combo identifiers are stored with WooCommerce cart/order data when applicable.

== Data retention ==

Uninstalling the plugin removes the plugin version option but intentionally retains combo rules and WooCommerce order metadata to avoid accidental store configuration or historical order-data loss. Store administrators can remove combo rules before uninstalling if they no longer need them.

== Screenshots ==

1. Manage combo discount rules, view eligible products and tiers, copy generated shortcodes, and quickly edit or delete existing rules.
2. Create a new combo rule with rule status, discount type, eligible products, and product category selection.
3. Configure flexible tiered discounts based on the minimum number of items selected by the customer.
4. Frontend combo builder displaying eligible products, available discount tiers, progress, and real-time combo totals.
5. Customers can select products and instantly unlock tiered combo discounts before adding the combo to the cart.
6. WooCommerce cart displaying combo products with automatically applied discounts and individual savings.

== Changelog ==

= 1.0.0 =
* Initial release.
* Added product/category combo rules.
* Added percentage and fixed discount tiers.
* Added simple and variable product support.
* Added server-side validation and product-level discount calculation.
* Added cart quantity protection and order metadata.
* Added HPOS compatibility declaration.
