ByticsLab Conditional Offers for WooCommerce

Turn "buy this, get that free" into an automatic promotion — no coding, no third-party tools. Set it up once in a few clicks, and the plugin handles the rest: checking every cart, applying the right free gift, enforcing limits, and tracking results. Plugin homepage: https://www.byticslab.com/plugins/conditional-offers-for-woocommerce/ Promotion types Pick one of five guided promotion types. Each one asks you for plain, simple details — no technical setup.

• Buy X Get Y — Buy a quantity of one product, get another product free. Example: Buy 2 water bottles, get 1 free.
• Spend X Get Y — Spend a set amount in the cart, get a free product. Example: Spend $50, get a free tote bag.
• Buy From Category — Buy anything from a chosen category, get a free product. Example: Buy any pair of shoes, get free socks.
• Spend X in Category — Spend a set amount within one category, get a free product. Example: Spend $100 on electronics, get a free charger.
• Choose Your Gift — Spend a set amount, and let the customer pick their own free gift from a list. Example: Spend $75, choose any one of three gifts.

Built for real stores

• Works with both the classic cart/checkout and WooCommerce Blocks.
• Usage limits — storewide or per customer — so a promotion can't be over-claimed.
• An Analytics tab shows gifts awarded, orders affected, and estimated value given away, in your store's own currency.
• A "Test Promotion" tool lets you simulate a cart and confirm a promotion works before it goes live.
• Thoroughly tested with hundreds of automated tests covering real checkout scenarios.
• Fully compatible with WooCommerce's High-Performance Order Storage (HPOS).
• Translation-ready, and built to respect customer privacy (data export/erase support included).

Built and maintained by ByticsLab — https://www.byticslab.com

1. Upload the plugin files to /wp-content/plugins/byticslab-conditional-offers-for-woocommerce, or install directly through the WordPress admin (Plugins → Add New → Upload Plugin).
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Requires WooCommerce 8.9 or later to be installed and active.

Multisite This plugin is site-scoped only: it does not support Network Activation, and activation will be refused with an explanatory notice if attempted network-wide. On a multisite install, activate it individually on each site that needs it, via that site's own Plugins screen. Each site gets its own independent set of promotions, settings, and database tables — nothing is shared network-wide.

1.0.5 Promotion messages, rebuilt:

• New: the promotion editor now has four separate, admin-editable message fields — before qualifying, qualified, gift added, and expired — each supporting {remaining}, {gift_name}, {gift_quantity}, and {promotion_name} placeholders filled in live with the real, current value.
• Improved: every message now shows your own text exactly as written, with no English wrapper glued on — a promotion titled in any other language now displays correctly.
• Improved: the "qualified" message is now a real confirmation naming the actual free gift (e.g. "You've unlocked: 1 free Cap!"), visually distinguished (green background, checkmark) from the "not yet qualified" one.
• New: the "gift added" and "offer has ended" messages now actually display, as a cart notice at the right moment — on the classic cart/checkout (Blocks Cart/Checkout support is planned for a future release). Fixes:
• Fixed: the cart-page "you've unlocked" / "add more to unlock" message and progress bar now actually appear on the classic cart — a bug meant this had never worked on a real storefront visit.
• Fixed: the "FREE GIFT" badge in the Mini-Cart drawer no longer shows as raw, unstyled HTML text.
• Fixed: a quantity-based promotion's "add more to unlock" message now shows a plain count ("add 2 more") instead of a currency amount.
• Fixed: a promotion message no longer names an out-of-stock or otherwise unavailable product as a free gift choice, and gift-quantity placeholders now reflect what you actually configured.
• Fixed: cart/mini-cart/product-page messages correctly stay hidden once you've turned the plugin off in Settings.

1.0.4

• Fixed: the "FREE GIFT" badge and the cart-page promotion messages/progress bar now also appear when your store's Cart page uses the WooCommerce Blocks cart (previously these only showed on the classic cart — a Blocks cart showed the free gift with no indication of why it was free, or that a promotion existed at all).
• No other changes — this release targets Blocks-cart parity only.

1.0.3

• Fixed: the order-edit screen now shows a friendly "Promotion gift: <name>" line instead of raw internal meta keys.
• Fixed: Analytics figures now display with your store's own currency symbol.
• Improved: a persistent navigation bar lets you move between Promotions, Analytics, and Settings from any screen.
• Improved: redesigned Analytics summary cards for better readability.
• Improved: consistent header and page layout across every admin screen.
• Improved: the promotion editor groups related fields (status/priority, product/quantity, etc.) onto the same row, with clearer labels and a helpful example placeholder.
• Improved: admin notices for a missing or outdated WooCommerce install are now shown only to users who can act on them.
• Now built and maintained by ByticsLab.

1.0.2

• Fixed across three further independent review rounds on the reservation/confirmation/release integrity path (3 P1 + 1 P2 + 1 P3 finding overall) — multi-promotion confirmation and confirmed-usage release made genuinely atomic (single-transaction, no compensating-call window), counter-decrement failures no longer ignored anywhere, stale .pot/package-lock.json metadata regenerated. 587 tests total across 11 suites. Full details: CHANGELOG.md in this plugin's own folder.

1.0.1

• Fixed after a further independent review (4 P1 + 4 P2 findings) — reservation TTL not refreshing on idempotent retry, privacy export/erasure pagination stopping after 10 orders, a non-deadlock reservation INSERT failure corrupting counters, the compiled admin bundle shipping with no source, usage confirmation failing open, analytics conflating uses with gift quantity, untranslatable admin UI strings, and an oversized readme. 548 tests total across 11 suites. Full details: CHANGELOG.md in this plugin's own folder.

1.0.0

• Phase 12 (per-request query memoization eliminating a duplicate cart-hot-path SQL query) and Phase 13 (packaging: README.md, samples/, the translation .pot file, load_plugin_textdomain(), and a verified real-install packaging test) — 529 tests total across 11 suites. Full details: CHANGELOG.md in this plugin's own folder.

0.12.0

• Fixed after an independent review of Phases 8-11 (3 P1 + 5 P2 findings) — Blocks checkout bypassing the usage/order lifecycle, non-atomic usage confirmation, missing privacy export/erase/retention, reservation-lifecycle timing, an unavailable gift still listed as choosable, the missing analytics screen, weak nested-field REST validation, and a failing JS lint gate. 525 tests total across 11 suites. Full details: CHANGELOG.md in this plugin's own folder. For the complete version history (every release back to 0.1.0), see CHANGELOG.md in this plugin's own folder.