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 Free Shipping Bar for Magento 2
Motivate customers to add more products to their cart with a dynamic free shipping progress bar.
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
- Create directory
app/code/SomePlus/FreeShippingBar - Copy module files to this directory
- 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.
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.
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.
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
| 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
| 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.
More from Some Plus
View vendorTurn 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.