Gift Ladder for WooCommerce

Gift Ladder for WooCommerce shows your customers a progress bar — in the cart, at checkout, and across your store — that fills as they add products. Each spending tier you configure automatically rewards them with a free gift the moment their cart total reaches it, encouraging larger orders and a higher average order value. You decide whether shoppers keep every gift they unlock along the way (cumulative) or only the single highest tier they reach. Gifts are real products or variations from your own catalog, added automatically at no charge — there is no need to create separate "free gift" products. There are no pro features, upsells, tracking scripts, or external libraries. Features:

• Enable or disable the feature.
• Set one or more spending tiers, each with its own threshold and gift.
• Choose whether customers keep every unlocked gift (cumulative) or only the highest tier.
• Search and select the exact free gift product or variation per tier.
• Choose progress and success bar colors.
• Display the progress bar across the storefront.
• Link the gift name to the product page.
• Use the [fgbfw_gift_bar] shortcode anywhere shortcodes are supported.
• Automatically add the gift when the cart reaches the threshold.
• Automatically remove the gift when the cart drops below the threshold.
• Force the gift price to zero.
• Exclude the gift from threshold calculations.
• Show the gift as a cart and order line item.
• HPOS compatible.

1.0.13

• Prefixed the shortcode (now [fgbfw_gift_bar]) so all plugin identifiers use the plugin's unique prefix.
• The free gift line is now prepared directly instead of re-invoking a WooCommerce core filter from within the plugin.

1.0.12

• Renamed the plugin to "Gift Ladder for WooCommerce".
• Added the "Requires Plugins: woocommerce" header.
• Clearer plugin description.

1.0.11

• Added the GPLv2 license header to the main plugin file.
• Set a valid Plugin URI and Author URI.
• Updated the "Tested up to" header for current WordPress compatibility.
• Added a languages directory with a translation template (.pot).
• Documented the intentional re-use of WooCommerce's core cart-item filter.

1.0.10

• Progress bar now updates live as the cart changes (add to cart, quantity, remove) by registering as a WooCommerce cart fragment — no page reload required, and it recovers correctly on cached pages.
• Redesigned the bar as a single continuous track from zero to the top tier, with a milestone marker for each tier that fills in as it unlocks.
• Smoothed the fill animation and refreshed the card styling.

1.0.9

• Added multiple gift tiers — configure any number of spending thresholds, each with its own free gift product or variation.
• Added a gift stacking mode: "cumulative" gives every gift the customer has unlocked, "highest only" gives just the best qualifying tier. Cumulative is the default.
• Progress bar now tracks the next tier and shows how many gifts are unlocked (e.g. "2 of 3 gifts unlocked").
• Existing single-gift settings are migrated automatically into the first tier on upgrade.

1.0.8

• Reworked sitewide bar placement to anchor directly below the theme header instead of guessing a content wrapper, fixing the Woodmart issue where the bar appeared inside the navigation menu and offset it.
• Bar now inserts after the full header block (including separate desktop/mobile headers) so it always lands below the menu and above the category or product title.
• Added fgbfw_bar_anchor_selector and fgbfw_bar_anchor_position filters to override placement per site without editing plugin files.

1.0.7

• Changed sitewide bar placement to insert before the main content wrapper instead of anchoring to the header.
• Fixed Woodmart navigation layout conflicts caused by inserting the bar inside header/menu rows.

1.0.6

• Improved Woodmart theme placement so the sitewide progress bar appears below the complete header/navigation area.
• Stopped using inner navigation elements as placement anchors to prevent menu offset/layout issues.

1.0.5

• Moved the sitewide progress bar below the theme header/menu instead of printing it above the header.
• Added a small vanilla JavaScript placement helper for themes without a standard after-header hook.

1.0.4

• Forced plugin-added gift cart items to pass checkout stock validation.
• Treated the selected gift product or variation as available for free gift checkout.
• Inserted gifts directly as zero-price cart items instead of relying on normal add-to-cart stock validation.
• Forced gift order line totals to zero.

1.0.3

• Added a direct cart insertion fallback when WooCommerce add-to-cart validation prevents the automatic gift from being added.
• Relaxed gift eligibility checks so selected gift products and variations can still be inserted as free cart lines.
• Updated the progress bar success state to confirm the gift exists in the cart.
• Displayed the progress bar across the storefront and linked the gift name to the product page.
• Added versioned release zip naming.

1.0.2

• Improved cart session syncing so qualified gifts are added before classic, AJAX, mini-cart, and checkout cart contents are read.
• Added a gift-specific cart item key and cart row class for more reliable gift line handling.
• Guarded cart recalculation during totals updates to prevent recursive recalculation.

1.0.1

• Improved gift syncing so qualified gifts appear as cart and order line items.
• Added support for visible free gift metadata on cart and order items.
• Improved progress bar styling with a gift box image.

1.0.0

• Initial release.