Bonusly Documentation

Overview

“Free gift from 60 €”: the gift is added to the cart automatically when the customer reaches the amount, with a progress bar that shows how much is left. Up to three gift levels.

• Customers add one more item to unlock their gift
• The gift is added to the cart automatically
• A progress bar shows exactly how much is left

Best for: Stores that want bigger Christmas carts

Installation

1. Download bonusly-free-gift.zip from My account › My plugins or from your order email. Do not unzip it.
2. In WordPress, go to Plugins › Add New Plugin › Upload Plugin, choose the zip and click Install Now, then Activate.
3. Go to WooCommerce › Free gift, set the amount and choose the gift.

Requires WordPress 6.0+, PHP 7.4+, WooCommerce 7.0+. Works with any theme, block themes and page builders.

Features

• Up to three gift levels (for example a sample from 40 €, a tote bag from 60 €, a candle from 100 €)
• The gift is added to the cart at price 0 as soon as the amount is reached, and removed if the cart goes back below
• Quantity locked to 1; customers can remove a gift they do not want, and add it back from the bar
• Progress bar with the gift pictures: "Spend 12 € more and get the Canvas tote for free!"
• Works with the classic cart, the block cart and checkout, mini carts and side carts
• Line on product pages: "Free gift: Canvas tote from 60 € of purchase"
• Shortcode [bonusly_bar] for landing pages and side carts
• Your texts and accent color
• Developer filters: bonusly_qualifying_item, bonusly_tiers, bonusly_show
• Lightweight: no jQuery required, no external service, no tracking

Shortcodes

Paste a shortcode in any page, post, widget or page builder text block.

• [bonusly_bar]

Options of each shortcode are described in the Features above and in the plugin settings page.

For developers

Customize the plugin from your theme’s functions.php or a small plugin, without editing its files (your changes survive updates).

Filters

• bonusly_qualifying_item
• bonusly_show
• bonusly_tiers

add_filter( 'bonusly_qualifying_item', function ( $value ) {
	// Change $value here.
	return $value;
}, 10, 1 );

Updates

Updates are free. When a new version is out, it appears in Dashboard › Updates of your WordPress site and you can install it in one click, or turn on automatic updates in Plugins. This works for the zip downloaded from your Woo-Plugins account; older copies can be replaced by downloading the latest version from My plugins. See the changelog.

Frequently asked questions