=== Shah Alam BOGO Offers ===
Contributors: devmdshahalam
Tags: woocommerce, bogo, buy x get y, free gift, discount
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create automated Buy X Get Y (BOGO) promotions for WooCommerce simple products with instant free gifts.

== Description ==

Shah Alam BOGO Offers is a lightweight WooCommerce plugin that automatically adds free products to the cart when customers meet your Buy X Get Y promotion rules.

Whether you want to run a classic Buy 3 Get 1 Free campaign or create custom Buy X Get Y offers, Shah Alam BOGO Offers makes it simple.

### Features

* Automatically adds free products to the cart.
* Configure Buy Quantity (X) and Free Quantity (Y).
* Apply promotions to all simple products or selected products only.
* Clean FREE badge displayed in Cart and Checkout.
* Automatically updates free item quantities when the cart changes.
* Automatically removes free items when requirements are no longer met.
* Fully Compatible with WooCommerce HPOS (High-Performance Order Storage).
* Lightweight and easy to use.
* No WooCommerce core modifications.

== Installation ==

1. Upload the `shah-alam-bogo-offers` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **BOGO Offers** in the WordPress admin menu.
4. Configure your Buy X Get Y campaign.
5. Save your settings.

== Frequently Asked Questions ==

= Does this plugin support variable products? =

No. Currently Shah Alam BOGO Offers supports WooCommerce Simple Products only.

= Does it support HPOS? =

Yes. Shah Alam BOGO Offers is fully compatible with WooCommerce High-Performance Order Storage (HPOS).

= Does it automatically update free products? =

Yes. Free items are automatically added, updated, and removed whenever the cart quantity changes.

== Changelog ==

= 1.0.1 =
* Initial release on WordPress.org.