someplus / module-free-shipping-bar

someplus/module-free-shipping-bar

Magento 2 Free Shipping Progress Bar - Motivate customers to reach free shipping threshold with a dynamic progress bar displayed in header, mini cart, cart page, and checkout.

  • SomePlus
magento2-module Compatibility: 2.4.7-2.4.9 Code Quality: Fail Tests: N/A Security: Pass proprietary

SomePlus Free Shipping Bar for Magento 2

Motivate customers to add more products to their cart with a dynamic free shipping progress bar.

Free Shipping Bar Preview

Features

  • 4 Display Positions - Header, Mini Cart, Cart Page, Checkout
  • 🎨 Fully Customizable - Colors, messages, and thresholds from admin
  • Real-time Updates - Bar updates instantly when cart changes
  • 🎉 Celebration Animation - Special animation when threshold is reached
  • 🌍 Multi-store Support - Different settings per store view
  • 📱 Responsive Design - Works on all devices

Requirements

  • Magento 2.4.x
  • PHP 8.1+

Installation

Via Composer (Recommended)

composer require someplus/module-free-shipping-bar
bin/magento module:enable SomePlus_FreeShippingBar
bin/magento setup:upgrade
bin/magento cache:flush

Manual Installation

  1. Create directory app/code/SomePlus/FreeShippingBar
  2. Copy module files to this directory
  3. Run:
bin/magento module:enable SomePlus_FreeShippingBar
bin/magento setup:upgrade
bin/magento cache:flush

Configuration

Navigate to Stores → Configuration → SomePlus → Free Shipping Bar

General Settings

Setting Description
Enable Turn the module on/off
Free Shipping Threshold Minimum cart amount for free shipping
Include Tax Include tax in calculation

Display Positions

Choose where to show the progress bar:

  • Header (sticky bar below header)
  • Mini Cart
  • Cart Page
  • Checkout Page

Design Settings

Customize colors:

  • Progress Bar Color
  • Background Color
  • Text Color
  • Achievement Color (when threshold reached)

Messages

Customize messages with placeholders:

  • {{remaining}} - Amount left to reach threshold
  • {{threshold}} - Target amount
  • {{current}} - Current cart total
  • {{percentage}} - Progress percentage

Changelog

1.0.0

  • Initial release
  • Header, minicart, cart, checkout positions
  • Admin configuration panel
  • Real-time cart updates
  • Customizable colors and messages

Support

For issues or feature requests, please contact [email protected]

License

Open Software License (OSL 3.0)

FreeShippingBar

No changelog yet

The vendor hasn't published a changelog. Tagged releases appear in the Versions tab.

Versions
Version Stability QA Status Compatibility Released
1.0.0 stable Fail Magento 2.4.7-2.4.9 Details 2026-07-25 16:20:58

Requires 6

Package Constraint
magento/framework >=103.0.0
magento/module-checkout >=100.4.0
magento/module-customer >=103.0.0
magento/module-quote >=101.2.0
magento/module-store >=101.1.0
php >=8.1

Compatibility

Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.

Compatibility matrix (Magento × PHP)
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 Pass Pass
2.4.8 Pass Pass
2.4.9 Pass Pass

Code Quality

Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge. A phpcs finding can't make a module incompatible.

Static analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

Static analysis results
Tool Status Findings Summary
PHPCS Warning 3 3 warnings (ruleset: Magento2), 3 auto-fixable with phpcbf
PHPMD Warning 6 6 rule violations (UnusedPrivateField:6)
Cpd Pass 0
Composer validate Info 6 valid; 6 advisory notes (composer validate --strict)

PHPStan

Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases.

PHPStan results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 1 1
2.4.8 1 1
2.4.9 1 1

Tests

Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.

Unit tests

Unit tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Integration tests

Integration tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Security

Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.

Security results
Tool Status Findings Summary
Composer audit Pass 0
Malware scan Pass 0
License
proprietary
Authors

More from Some Plus

View vendor
Make it pay

Turn an existing module into recurring revenue.

If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.