=== GT BOGO Engine for WooCommerce ===
Contributors: graphictshirts
Tags: bogo, buy one get one, woocommerce discount, free gift, promotional pricing
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.0
Stable tag: 3.11.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Enterprise Buy X Get Y automation for WooCommerce. 200 industry Pro Packs, 15 Superpowers, full white-label customer emails, and enterprise campaign tools — all automatic.

== Description ==

**GT BOGO Engine** is the most powerful BOGO (Buy X Get Y) plugin for WooCommerce. Designed for serious stores that need more than a basic discount plugin — it gives you complete enterprise-grade control over promotional pricing, applied automatically at checkout with zero friction for your customers.

No coupon codes. No manual intervention. Every deal fires automatically.

= Free Features =

* **Free Core Rule** — Configure a global Buy X Get Y rule applied automatically across your entire store
* **Product Badges** — Display BOGO badges on qualifying products in your shop
* **Cart Progress Bar** — Show customers how close they are to unlocking a deal
* Full WooCommerce compatibility (Simple, Variable, Grouped products)
* Lightweight — no bloat, no page speed impact

= PRO Features =

**200 Industry Pro Packs**
Ready-built rule sets covering every retail vertical — Food & Dining, Fashion & Apparel, Beauty & Wellness, Automotive, Tech & Software, Health, Education, Travel, Events, Sports & Fitness, B2B Wholesale, and more. Each pack includes multiple pre-configured BOGO rules ready to activate in one click.

**Bundle License System**
* Starter Revenue Bundle — 5 packs
* Growth Acceleration Bundle — 9 packs
* Complete BOGO Arsenal — 15 packs
* One license key unlocks all packs in your bundle automatically

**Rule Management**
* Unlimited PRO rules with priority ordering and conflict resolution
* Import rule templates in one click from the Pro Packs vault
* Full rule conditions — category, cart value, day of week, time window targeting

**Enterprise Targeting**
* Customer Segmentation — First-time, returning, VIP, spend-based targeting
* Geographic Targeting — Country-level include/exclude lists
* Product Variant Rules — Target specific sizes, colors, or attributes
* Deal Lockout — Prevent stacking on sale items, set max discount caps

**Campaign Management**
* Campaign Scheduler — Auto-activate and deactivate rules by date and time
* A/B Testing — Split-test two rules and measure winner by conversion and revenue
* Multi-Currency — Override deal thresholds per currency (WPML/Aelia/WMC compatible)
* Deal Page Manager — Auto-generate a customer-facing /deals page

**White-Label Customer Email System**
10 fully designed transactional email templates sent to your customers under your store's brand. GT BOGO Engine is never visible to your customers. Emails include:
* BOGO Deal Confirmation
* Loyalty Tier Upgrade
* Streak Bonus Applied
* Referral Reward Earned
* VIP Status Unlocked
* Free Gift Added
* Deal Expiry Warning
* Cart Abandonment Nudge
* Threshold Almost Reached
* Winback Campaign

All emails use your store name, logo, and accent color pulled automatically from WooCommerce settings. Sent via wp_mail() with optional Mailchimp/Klaviyo extension.

**Analytics & Reporting**
* Real-time Dashboard — Live cart monitor, activity feed, sparklines
* Analytics — Revenue influenced, rules fired, orders affected, top rule
* ROI Projector — Forecast revenue impact before launching a campaign
* PDF Export — Generate professional reports for clients and executives
* Audit Log — Full history of rule changes

**Integrations & Developer Tools**
* REST API — 5 endpoints for headless WooCommerce, mobile apps, and Zapier
* Import / Export — Full JSON backup and restore with merge or replace mode
* Mailchimp & Klaviyo integration — Tag customers and fire events on deal redemption
* Webhook support — Fire POST requests on rule activation and redemption
* White Label — Rename the plugin, hide branding, set agency support URLs

**15 Superpowers**
Exit Intent Popup, Announcement Bar, Dynamic Pricing Display, Bundle Spotlight, Cart Abandonment Nudge, Deal Share Button, Smart Popup, Countdown Timer, Social Proof, Savings Calculator, Cart Recommendations, Quick Add Button, Email Notifications, Product Badges PRO, Cart Progress Bar PRO

= Why GT BOGO Engine? =

* **200 Pro Packs** — The largest library of ready-built BOGO rule sets for any industry
* **Luxury brand safe** — No hardcoded fonts or colors. Everything inherits your active theme
* **Zero customer friction** — Discounts apply silently in the cart. No codes, no pop-ups required
* **White-label emails** — Your customers only ever see your store's brand, never GT BOGO Engine
* **Developer friendly** — Full REST API, import/export, webhook support, and WP-Cron scheduling
* **Conflict-free** — Built-in conflict resolver detects and manages overlapping rules automatically

= Purchase PRO =

Visit [graphictshirts.shop/bogo](https://graphictshirts.shop/bogo/) to purchase a PRO license or any of the 200 industry Pro Packs.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the WordPress plugin installer
2. Activate the plugin through the **Plugins** menu
3. Navigate to **GT BOGO Engine** in your WordPress admin sidebar
4. Configure your free global rule under **Free Core Rule**
5. Optionally activate your PRO license under **License** for unlimited rules and enterprise features

== Frequently Asked Questions ==

= Does this work with variable products? =
Yes. GT BOGO Engine supports Simple, Variable, Grouped, and External product types. Variant Rules (PRO) let you target specific attribute combinations.

= Will it conflict with WooCommerce coupons? =
By default BOGO rules and coupons can coexist. Use Deal Lockout (PRO) to prevent stacking if desired.

= Does it work with WPML or multi-currency plugins? =
Yes. Multi-Currency (PRO) supports WPML/WooCommerce Multilingual, Aelia Currency Switcher, and WooCommerce Currency Switcher.

= Do my customers see GT BOGO Engine branding? =
Never. All customer-facing text, emails, cart notices, and checkout line items use your store name. GT BOGO Engine is completely invisible to your customers.

= How do Pro Packs work? =
Purchase a Pro Pack or Bundle from the PRO Rules / Packs page. Your license key is emailed instantly. Enter the key in the plugin and your packs appear in the vault ready to import with one click.

= Is customer data stored? =
No customer PII is stored by the plugin. Analytics track aggregate metrics only.

= Will this slow down my store? =
No. Rules are cached via WordPress transients. The cart calculation hook runs only on cart/checkout pages.

== Screenshots ==

1. Dashboard — live cart monitor, metrics, and activity feed
2. PRO Rules / Packs — 200 industry Pro Packs with bundle purchasing
3. Campaign Scheduler — schedule rules to fire automatically
4. Analytics — revenue influenced, rules fired, ROI tracking
5. Superpowers — 15 customer-facing engagement features
6. Settings — customer email toggle and accent color picker
7. REST API — headless WooCommerce integration

== Changelog ==

= 3.11.0 =
* Added: 200 industry Pro Packs covering every retail vertical (Food, Fashion, Beauty, Automotive, Tech, Health, Education, Travel, Events, Sports, B2B, and more)
* Added: Bundle license system — one key unlocks all packs in Starter (5), Growth (9), or Complete (15) bundles
* Added: White-label customer email system — 10 transactional email templates using store name, logo and accent color
* Added: Customer email toggle and accent color picker in Settings page
* Added: IPN handler expanded to all 200 packs with keyword mapping
* Added: Email sender rebuilt — no token/zip references, clean license-key-only delivery
* Added: send_bundle_license_email — single key email listing all included packs
* Added: PayPal SDK enqueued in wp_head for faster button render
* Fixed: Bundle PayPal buttons rendering correctly with per-bundle SDK embeds
* Fixed: Bundle panel text left-aligned
* Fixed: Double arrow on PayPal quantity select removed
* Fixed: Scroll restoration on PRO Rules page
* Fixed: Dashboard queried non-existent DB columns
* Fixed: Conflict Resolver resolution actions
* Fixed: Conditions page Match ALL/ANY buttons now clickable
* Added: REST API controller — 5 endpoints under gt-bogo/v1
* Added: WP-Cron scheduler execution
* Added: White Label admin hook

= 3.10.1 =
* Added: 7 new Superpower classes (Exit Intent, Announcement Bar, Dynamic Pricing, Bundle Spotlight, Cart Abandonment Nudge, Deal Share, Smart Popup)
* Added: 10 new enterprise admin pages
* Added: Per-superpower enable/animate toggles and intensity settings
* Added: Navigation restructured into ENTERPRISE/PRECISION/GROWTH sections
* Added: Custom PHP obfuscator for customer distribution

= 3.10.0 =
* Major rebuild — enterprise admin UI system
* Added: Segment targeting, A/B testing, geo targeting
* Added: Campaign scheduler with WP-Cron integration
* Added: Analytics dashboard with Chart.js visualizations

== Upgrade Notice ==

= 3.11.0 =
Major feature release. Adds 200 industry Pro Packs, bundle license system, white-label customer email system, and PayPal button improvements. Upgrade recommended for all users.
