=== GT BOGO ENGINE for WooCommerce ===
Contributors: graphictshirts
Tags: woocommerce, bogo, discounts, coupons, marketing, buy one get one, checkout, cart, rules
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 3.5.17
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Smart Buy X Get Y (BOGO) promotions for WooCommerce with a visual rules builder. Includes a free global BOGO rule plus advanced rule logic.

== Description ==

GT BOGO ENGINE for WooCommerce lets you build clear, high-converting Buy X Get Y offers in your WooCommerce store.

Examples include:
- Buy 1 Get 1 at 50% Off (global rule included for free)
- Buy 2 Get 1 Free
- Buy 3, get the cheapest item 40% off
- Category-targeted BOGO deals
- Product-specific promotions

Discounts are applied automatically in the cart and checkout. No coupon codes required.

This plugin is built by GRAPHIC T-SHIRTS (https://graphictshirts.shop), a premium streetwear brand running WooCommerce at scale. GT BOGO ENGINE uses the same logic applied to real-world production promotions.

Sales and PRO information:
https://graphictshirts.shop/bogo

Support contact:
support@graphictshirts.shop

== Key Features ==

- Free global rule: Buy 1 Get 1 at 50% Off
- Automatic discounts in cart and checkout with no coupon friction
- Visual rule builder admin UI
- Scope rules globally, by category, or by product
- Percentage discounts or free-item outcomes depending on rule configuration
- Compatible with most WooCommerce themes
- Supports multiple rules and priorities
- Designed to feel like a native WooCommerce extension

== Free vs PRO-Style Features ==

The free core includes:
- One global BOGO rule: Buy 1 Get 1 at 50% Off
- Rule builder UI for the free core rule
- Engine enable and disable toggle
- Optional debug output

The PRO-style rule engine (already wired into the UI) is designed to be extended with:
- Multiple simultaneous BOGO rules
- Buy X Get Y Free logic
- Cheapest item discount logic
- Category-only BOGO rules
- Product-only BOGO rules
- Advanced conditions such as cart total, date ranges, and user roles

The admin interface is intentionally commercial-grade so store owners feel confident using it from day one.

== Installation ==

1. Download the plugin ZIP file.
2. In WordPress admin, go to Plugins then Add New then Upload Plugin.
3. Upload the ZIP file and click Install Now.
4. Activate the plugin.
5. Go to GT BOGO ENGINE then Settings and enable the engine.
6. Go to GT BOGO ENGINE then Free Core Rule and confirm the default Buy 1 Get 1 at 50% Off rule is active.
7. Optionally, go to GT BOGO ENGINE then PRO Rules to add additional rules if available.

== Usage ==

1. Enable the engine  
   Go to GT BOGO ENGINE then Settings and ensure Enable GT BOGO ENGINE is turned on.

2. Configure the free global rule  
   Go to GT BOGO ENGINE then Free Core Rule:
   - Set a rule title
   - Keep the rule enabled
   - Set discount type to Percent and value to 50
   - Keep scope global or narrow to categories or products

3. Add advanced rules (optional)  
   Go to GT BOGO ENGINE then PRO Rules:
   - Add a new rule
   - Set Buy Quantity and Get Quantity
   - Choose discount type
   - Set scope
   - Enable and save

4. Test in cart  
   - Open a private browser window
   - Add qualifying products to cart
   - Verify discount appears automatically

== Screenshots ==

1. GT BOGO ENGINE admin dashboard with branding and quick links
2. Free core rule editor showing Buy 1 Get 1 at 50% Off
3. PRO rules builder interface
4. WooCommerce cart displaying automatic BOGO discount

== Frequently Asked Questions ==

Do I need WooCommerce?  
Yes. WooCommerce must be installed and active. If it is not active, the plugin will display an admin notice and will not run.

Does this plugin use coupons?  
No. Discounts are applied directly in the cart using rule logic. This reduces customer friction.

Does it work with all themes?  
GT BOGO ENGINE works with any theme that properly supports WooCommerce. Always test promotions in a staging environment.

Will it slow down my store?  
The rules engine is lightweight. As with all promotion logic, avoid excessive numbers of rules on very large catalogs.

How do I get support?  
Email: support@graphictshirts.shop  
Website: https://graphictshirts.shop  
Sales page: https://graphictshirts.shop/bogo

Please include your WordPress version, WooCommerce version, theme name, and a description of your setup.

== Changelog ==

= 3.5.17 =
- Initial public release
- Free global rule: Buy 1 Get 1 at 50% Off
- Visual admin UI for settings and rules
- PRO rule scaffolding
- WooCommerce dependency checks and safe activation

== Upgrade Notice ==

= 3.5.17 =
First public release of GT BOGO ENGINE for WooCommerce. Test promotions in a staging or private browser before running large campaigns.

