This module creates bonuses visible in the cart The feature is actually a cart price rule which can be triggered under certain conditions. On the storefront the user will notice a progress bar that hints at a potential bonus when meeting a subtotal threshold.

Installation

This module is optional

composer require "creativestyle/magesuite-cart-bonus" ^1.0.0

User manual

3.3. Cart Bonus

Admin settings

To add a cart bonus a new sales rule should be created in Marketing -> Promotions -> Cart price rules

The rule must be set as No coupon

In the Cart bonuses tab, a rule can be cart-bonus It is also possible to hide the rule label in order to make it a surprise for a user.

Free shipping rule is set as a cart bonus with a hidden label. The label is visible when a user passes the threshold.

Backend

Template

app/design/frontend/creativestyle/theme-creativeshop/MageSuite_CartBonus/templates/status.phtml

<?php /** @var $block \Creativestyle\CartBonusExtension\Block\Status */
$status = $block->getBonusesStatus();

$progressToNextBonusPercentage = $status->getProgressPercentage();
$amountToNextLevel = $status->getRemainingAmountForNextBonusWithCurrency();
$awardedBonusesCount = $status->getAwardedBonusesCount();
$allBonusesCount = $status->getBonusesCount();
$isFirstNotAwarded = true;
$tooltipLeftLimit = $this->getTooltipLeftLimit();
$tooltipRightLimit = $this->getTooltipRightLimit();

.........

Block

vendor/creativestyle/magesuite-cart-bonus/Block/Status.php:32

class Status extends \Magento\Framework\View\Element\Template
{
    public function getBonusesStatus()
    {
        $totals = $this->cart->getQuote()->getTotals();
        $currentCartValue = $totals['subtotal']['value'];

        return $this->statusBuilder->build($currentCartValue);
    }
}

Service

vendor/creativestyle/magesuite-cart-bonus/Service/StatusBuilder.php:51

Model

vendor/creativestyle/magesuite-cart-bonus/Model/Bonus/Status.php:34

Plugin

vendor/creativestyle/magesuite-shipping-addons/Plugin/Checkout/Block/Cart/Totals/AddFreeShippingBarVariables.php:40

Frontend

Each bonus is displayed as a section of a bar. After cart page is loaded the progress bar is animated.

PHTML template

The PHTML template is placed in theme-creativeshop/src/MageSuite_CartBonus/templates/status.phtml

It is possible to pass some configuration from the layout - theme-creativeshop/src/MageSuite_CartBonus/layout/default.xml

Also, paths or configurations for the following icons can be adjusted:

bonus.gift.icon.headline
bonus.gift.icon.gift
bonus.gift.icon.status

Styling

The styling for this component is provided by default in theme-cerativeshop. Styles are placed in components/cart/cart-bonus file.

MageSuite Developer Documentation

CartBonus (optional)

Analytics