=== BOGO Plus for WooCommerce ===
Contributors:      rashmiwp
Tags:              bogo, buy one get one, woocommerce, sale, coupon
Tested up to:      6.9
Stable tag:        1.1.0
License:           GPL-3.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-3.0.html


BOGO Plus For WooCommerce makes Buy One, Get One promotions so easy!

== Description ==

**BOGO Plus for WooCommerce** lets store owners create clear and reliable Buy One, Get One (BOGO) promotions using WooCommerce’s built-in coupon system.

The plugin focuses on **same-product BOGO offers**, meaning when a customer qualifies for a deal like **Buy 3, Get 2 Free**, the **same product is automatically added to the cart as a free item**, clearly marked and priced at $0.00.

BOGO Plus also continues to support **percentage-based BOGO discounts**, such as **Buy One, Get One 50% Off**, giving you flexibility to run different types of promotions without complex pricing tricks.

All rules are configured directly inside WooCommerce coupons, keeping the experience simple, familiar, and predictable for both store owners and customers.

Developed in partnership with [SiteWired.com](https://www.sitewired.com), BOGO Plus for WooCommerce is designed to deliver reliable, real-world Buy One, Get One promotions for WooCommerce stores & fully compatible with **WooCommerce HPOS (High-Performance Order Storage)**.

---

== Features ==

- **Same-Product Buy X, Get Y Free**
  Create offers like Buy 2 Get 1 Free, Buy 3 Get 2 Free, or Buy 5 Get 1 Free.  
  Free items are automatically added to the cart as separate lines and clearly labeled.

- **Buy One, Get One % Off**
  Offer percentage-based deals such as Buy One, Get One 50% Off using standard WooCommerce coupon settings.

- **Automatic Free Item Handling**
  Free products are added and removed automatically as cart quantities change.

- **Clear Cart Display**
  Free items appear with a $0.00 price and a clear label so customers always understand the offer.

- **Start Date for Coupons**
  Schedule promotions in advance by setting a coupon start date.

- **WooCommerce-Native Setup**
  All configuration is done inside WooCommerce’s existing coupon interface.

- **HPOS Compatible**
  Fully compatible with WooCommerce High-Performance Order Storage for modern, scalable stores.

- **User-Friendly**
  Designed to be simple and intuitive for store owners of all experience levels.

---

== Requirements ==

* WordPress 5.8 or higher
* WooCommerce 6.0 or higher
* WooCommerce coupons must be enabled

---

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/` directory, or install the plugin through the WordPress Plugins screen.

2. Activate the plugin through the **Plugins** menu in WordPress.

3. Go to **Marketing → Coupons** in your WordPress admin.

4. Click **Add New Coupon**.

5. Enter basic coupon details such as Coupon Code, Description, Start Date, and Expiry Date.

6. Choose the type of promotion you want to create:

   **Buy X, Get Y Free (Same Product)**
   - Select **Buy X, Get X Free** as the coupon type.
   - Enter values for:
     - **Buy X Item(s)** (e.g., 3)
     - **Get Y Item(s) Free** (e.g., 2)
   - Example: Buy 3 Get 2 Free will automatically add 2 free units of the same product to the cart.
   - Leave the **Coupon Amount** field empty for this type.

   **Buy One, Get One % Off**
   - Select **Buy One, Get One % Off** as the coupon type.
   - Enter the discount percentage in the **Coupon Amount** field.
   - Example: Enter 50 for a Buy One, Get One 50% Off offer.

7. Save the coupon — the promotion is now active.

---

== Notes ==

- Free items are added as separate cart lines and clearly marked as free.
- The plugin is fully internationalized and ready for translation.
- Designed to work with modern WooCommerce setups and performance features.

== Changelog ==

= 1.1.0 =
* Fixed an issue where Buy One, Get One Free coupons did not always apply correctly in certain cart scenarios.
* Improved overall stability of same-product BOGO promotions.

== Screenshots ==

1. Buy One, Get One % Off Coupon set up
2. Buy X, Get Y Free ( BOGO ) Coupon set up
3. Option to apply Coupon Start Date for future promotions

