Product Gifts – Free Gifts with Purchase for Botble E-commerce

Product Gifts for Botble E-commerce Overview & Conditional Gift Rule Engine

Product Gifts for Botble E-commerce is a Laravel-based plugin engineered for Botble CMS store operators to automate conditional free-gift promotions across product, cart, and checkout surfaces. The module resolves the operational bottleneck of manually configuring giveaways by evaluating rule sets — minimum order value, product membership, or category membership — against live cart state and injecting qualifying gift line items at a $0 price. In agency delivery workflows, the package installs under platform/plugins/ecommerce-product-gifts and is administered entirely from the Ecommerce area of the Botble panel.

Technical Specifications & Deployment Matrix

Rule Evaluation Pipeline & Gift Fulfillment Mechanics

The engine’s core mechanism is server-side rule evaluation against live cart state before checkout rendering. When a customer loads a product page or the cart, the module queries published rules, matches each rule’s targeting predicate — store-wide, an explicit product list, or category sets — against current cart composition, and verifies the configured minimum subtotal threshold. Qualifying rules then surface a gift selector rendered in one of four configurable visual treatments (Modern, Minimal, Classic, or Elegant), styled through a custom primary color token, an optional emoji icon, and a full or compact display mode. The customer’s selection persists through the AJAX cart-to-checkout transition and materializes as a distinct $0 line item on the final order record, preserving revenue reporting integrity. Rules also accept start and end dates, so campaigns activate and expire on schedule without manual toggling. For teams evaluating parallel merchandising logic on the WooCommerce stack as a separate codebase, WooCommerce AI delivers up-sell, cross-sell, and recommendation engines as an independent runtime rather than a Botble extension.

Core Technical Capabilities of Product Gifts

• Tiered threshold architecture: multiple rules can coexist at escalating subtotals (for example $50, $100, $200), and a customer qualifying for several tiers selects one gift per tier, enabling structured upsell ladders.
• Scoped targeting predicates: each rule binds to all products, a specific product selection, or product categories, keeping evaluation queries narrow and predictable across large catalogs.
• Multivendor and SaaS isolation: since 1.0.1 the package supports multivendor deployments, with 1.0.5 enforcing rule isolation so vendor-scoped rules never leak into other vendors’ storefronts; Ecommerce SaaS 1.0.2+ operators activate once from the Operator console while individual stores enable the app from their Apps screen.
• Inventory-aware fallback: evaluation automatically skips gift items without available stock — including digital or downloadable gifts that do not track inventory, a case corrected in 1.0.6 — preventing selection failures at fulfillment.
• Localization and permissions: translation-ready strings ship across 30+ languages, paired with granular role-based permission controls governing administrative access to rule management.

Production Implementation & Operational Resilience

Deployment follows the standard Botble plugin lifecycle: extract the archive, upload to platform/plugins/ecommerce-product-gifts, activate from the Plugins screen, and refresh the site. Since version 1.0.7, database migrations are idempotent across re-activations, so the schema can be rebuilt safely when the package is toggled on a staging or production host, and activation settings render only for super administrators — a guard against tenant-level misconfiguration in SaaS environments. Front-end state drift is handled directly in the codebase: 1.0.4 removed duplicate gift selectors injected during AJAX checkout requests, normalized the selector container class to prevent collisions with checkout warning components, and restored vendor-dashboard create and edit views for marketplace operators.

Before deployment, administrators should verify Botble CMS 7.6.4 or higher and PHP 8.2 or higher, since the package’s internal contracts target those runtimes; MySQL 5.x and 8.x are both supported persistence backends. The codebase ships lightweight JavaScript and Sass-compiled CSS with no bundled page-builder dependency, keeping page-load overhead minimal. Secondary development centers on rule configuration and presentation overrides — display styles, colors, section titles, and show/hide toggles — rather than core engine modification, since gift evaluation and order writing are handled internally. For growth teams weighing standalone referral tooling on an unrelated Worksuite platform, Affiliate Module for Worksuite SAAS exists as a decoupled alternative outside the Botble runtime.