WP Manifestindependent plugin directory
manifest / ecommerce / buy-x-get-y

Jacklabs Advanced BOGO & Free Gifts for WooCommerce

Buy X Get Y, Mix & Match, Smart Promotion Rules, Choose Free Gift, Tiered BOGO, Spend X Get Y, Analytics & Profit Guard for WooCommerce.

by Jacklabs · github.com/ngoctuanit07/buy-x-get-y · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/ngoctuanit07/buy-x-get-y/archive/refs/heads/main.zip
Readme github.com/ngoctuanit07/buy-x-get-y ↗

WC requires at least: 7.0 WC tested up to: 9.0 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Buy X Get Y, Mix & Match, Choose Free Gift, Tiered BOGO, Spend X Get Y, Progress Bar, Analytics & Smart Promotion Rules for WooCommerce.

Description

Jacklabs Advanced BOGO & Free Gifts for WooCommerce is a full promotion rules engine focused on BOGO, free gifts, mix & match, targeting, and campaign analytics.

Core features

  • Buy X Get Y (same product, different product, variations, categories, tags)
  • Buy 1 Get 1, Buy 2 Get 1, flexible quantities + repeat rules
  • Discount types: Free, Percentage, Fixed amount, Fixed price
  • Auto-add free gifts or customer gift selection popup
  • Mix & Match / category-based BOGO
  • Cheapest / most expensive item free or discounted
  • Spend X Get Y and cart quantity / subtotal gifts
  • Tiered BOGO and multi-gift tiers
  • Scheduled campaigns (date range + recurring days/hours)
  • Countdown timer, progress bar, dynamic messages
  • Product badges and promotion banners
  • Coupon requirement / exclusion and promotion stacking control
  • Customer role, new/returning, lifetime spend, country, payment, device, UTM targeting
  • Usage limits, per-customer limits, gift stock scarcity, campaign budget
  • Analytics dashboard: revenue, gift cost, ROI, gift popularity
  • Visual / JSON rule builder, templates, clone, import/export
  • REST API + developer hooks/webhooks
  • HPOS and Cart/Checkout Blocks friendly
  • AI rule assistant (offline parser + optional API) and campaign simulator

Shortcodes

  • [jl_bxgy_progress] — progress toward gifts
  • [jl_bxgy_countdown] — campaign countdown
  • [jl_bxgy_banner] — promotion banner

REST API

Namespace: jl-bxgy/v1

  • GET/POST /promotions
  • GET/PUT/DELETE /promotions/{id}
  • GET /bogo/rules (public summary)
  • GET /analytics/{id}
  • GET /cart/plan

Developer hooks

  • jacklabs_bogo_rule_matched
  • jacklabs_bogo_before_apply
  • jacklabs_bogo_after_apply
  • jl_bxgy_evaluation_plan
  • jl_bxgy_gift_cart_item_data
  • Filters: jl_bxgy_product_price, jl_bxgy_stacking_mode, and more

Installation

  1. Upload the plugin folder to /wp-content/plugins/
  2. Activate Jacklabs Advanced BOGO & Free Gifts for WooCommerce
  3. Ensure WooCommerce is active
  4. Go to BOGO & Gifts → Add Promotion and create your first rule

Frequently Asked Questions

Does it work with Cart/Checkout blocks?

Yes. Gift lines and discounts are applied via the cart session and Store API extension data. Gift popup uses AJAX compatible with blocks pages.

HPOS compatible?

Yes. Custom order tables compatibility is declared; analytics use plugin tables and WC CRUD.

Changelog

1.0.0

  • Initial production release — full promotion rules engine