=== Kombat BOGO - Buy One Get One for WooCommerce ===
Contributors: d_alinus2004
Tags: woocommerce, bogo, buy one get one, promotions, discounts
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create "Buy X Get Y Free" promotions in WooCommerce. Simple, visual, ready to use.

== Description ==

**Kombat BOGO** turns your WooCommerce store into a sales machine with easy-to-configure BOGO (Buy One Get One) rules.

Want to offer "Buy 2, Get 1 Free" or "Buy product A → Get product B as a gift"? With Kombat BOGO you can set this up in less than 1 minute.

= Key features =

* ✅ **Buy X Get X** - Buy 2 of the same product, get 1 free
* ✅ **Buy X Get Y** - Buy product A, get product B free
* ✅ **Product page message** - Automatic notification under the Add to Cart button
* ✅ **Progress bar in cart** - Shows customers how many more they need for the gift
* ✅ **Success message** - Confirmation when the gift has been unlocked
* ✅ **Automatic gift in cart** - Gift appears by itself, no manual action needed
* ✅ **"FREE GIFT" badge** clearly visible in the cart and checkout
* ✅ **Strikethrough original price + "FREE"** displayed for the gift item
* ✅ **"You saved" row** under the cart total
* ✅ **Customizable texts and colors** from admin
* ✅ **Translation-ready** (.pot file included)
* ✅ **HPOS compatible** (High-Performance Order Storage)

= Why Kombat BOGO? =

* **Simple** - Setup in less than 1 minute
* **Visual** - Modern, intuitive admin interface
* **Lightweight** - Optimized code, no overhead
* **Compatible** - WooCommerce 6.0+ and HPOS
* **Customizable** - All texts and colors are editable

= Kombat BOGO PRO =

Need more power? **Kombat BOGO PRO** builds on the free version and unlocks:

* **Unlimited offers running at the same time** (the free version runs one offer at a time)
* **Percentage discounts** - give the second item at any % off, not only 100% free
* **Scheduling** - set start and end dates for each offer
* **Category rules** - apply BOGO to entire product categories
* **Variable products** support
* **Usage statistics** per offer
* **Max gifts per order** limit

Learn more: [Kombat BOGO PRO](https://webdesign-profesional.com/product/kombat-bogo-pro/)

The free plugin is fully functional on its own - PRO is optional.

== Installation ==

1. Upload the `kombat-bogo` folder to `/wp-content/plugins/`
2. Activate the plugin from the Plugins menu
3. Go to **Kombat BOGO → Add Rule** and create your first promotion
4. Activate the rule and you're ready!

== Frequently Asked Questions ==

= Does it work with variable products? =

The free plugin supports simple products only. Variable product support is available in Kombat BOGO PRO.

= Can I have multiple active rules at the same time? =

In the free version, only one active rule at a time. Saving multiple rules is possible, but activating a new one will automatically deactivate the previous active rule. Running multiple offers simultaneously is available in Kombat BOGO PRO.

= Is there a PRO version? =

Yes. Kombat BOGO PRO adds unlimited simultaneous offers, percentage discounts, scheduling, category rules, variable products and usage statistics. See [Kombat BOGO PRO](https://webdesign-profesional.com/product/kombat-bogo-pro/). The free plugin remains fully functional on its own.

= How does the message appear to customers? =

The message appears automatically on the product page, in the cart, and in the mini-cart. All texts are customizable from the Settings page.

= Is the plugin compatible with Elementor / WooCommerce Blocks themes? =

Yes, it uses standard WooCommerce hooks, so it's compatible with most themes.

= Does it support caching plugins (LiteSpeed, WP Rocket)? =

Yes, it uses native WooCommerce cart mechanisms which are not affected by caching.

= Is HPOS supported? =

Yes, the plugin declares full compatibility with WooCommerce's High-Performance Order Storage.

== Screenshots ==

1. BOGO rules list in admin
2. Creating a new rule - simple and visual
3. Message on product page
4. Progress bar in the cart
5. Gift automatically added to cart with FREE badge

== Changelog ==

= 1.2.0 =
* Added a 'Kombat BOGO PRO' info box on the settings page and a 'Go PRO' link on the plugins list
* Documented PRO features in the description and FAQ

= 1.1.1 =
* Security hardening: sanitize the request array before passing it to save-rule filters
* Security hardening: re-validate the message color as a hex value before printing it into inline CSS (escape late)

= 1.1.0 =
* Renamed from "Promo BOGO" to "Kombat BOGO" — part of the Kombat plugin family
* Updated text domain to `kombat-bogo`
* Code quality improvements

= 1.0.9 =
* Fixed translators comment placement for Plugin Check compliance

= 1.0.8 =
* Plugin Check compliance: fixed all errors and most warnings
* Updated "Tested up to" to WordPress 6.9

= 1.0.5 =
* Added validation for variable products (returns clear error message)
* Improved admin UX with informational notices

= 1.0.4 =
* Updated plugin links
* Updated Plugin URI to direct product page

= 1.0.3 =
* Internationalization: plugin fully translated to English
* Improved gift display in cart and checkout (strikethrough price + FREE badge)
* New "You saved" row under cart/checkout total
* Gift type clearly marked in order details (admin + email)

= 1.0.2 =
* Added animated FREE GIFT badge next to gift product name
* Strikethrough original price with FREE label
* Total savings displayed under cart and checkout total
* Gift meta saved to order line items

= 1.0.1 =
* Fixed product search in admin (using native WooCommerce wc-product-search)

= 1.0.0 =
* Initial release
* Buy X Get X rules (same product)
* Buy X Get Y rules (different product)
* Customizable messages
* HPOS compatibility

== Upgrade Notice ==

= 1.1.0 =
Plugin renamed to Kombat BOGO. Existing rules and settings are preserved.
