Title: Softminal Cart Reward Progress Bar Author: Softminal Published: Jawza 3, 2026 Last modified: Aqırap 1, 2026 --- Search plugins ![](https://ps.w.org/softminal-cart-reward-progress-bar/assets/banner-772x250.png? rev=3521741) ![](https://ps.w.org/softminal-cart-reward-progress-bar/assets/icon-256x256.png? rev=3723300) # Softminal Cart Reward Progress Bar By [Softminal](https://profiles.wordpress.org/softminal/) [Download](https://downloads.wordpress.org/plugin/softminal-cart-reward-progress-bar.1.2.0.zip) * [Details](https://kaa.wordpress.org/plugins/softminal-cart-reward-progress-bar/#description) * [Reviews](https://kaa.wordpress.org/plugins/softminal-cart-reward-progress-bar/#reviews) * [Installation](https://kaa.wordpress.org/plugins/softminal-cart-reward-progress-bar/#installation) * [Development](https://kaa.wordpress.org/plugins/softminal-cart-reward-progress-bar/#developers) [Support](https://wordpress.org/support/plugin/softminal-cart-reward-progress-bar/) ## Description **Softminal Cart Reward Progress Bar** displays a dynamic, live-updating progress bar in your store that motivates customers to add more items to their cart in order to unlock rewards like free shipping, discounts, or free gifts. It works seamlessly with **WooCommerce**, **SureCart**, and **FluentCart** — giving you the flexibility to use it across different eCommerce platforms on the same WordPress site. When a shopper adds products to their cart, the bar updates in real time — no page reload required — showing how close they are to earning a reward. This creates a sense of urgency and encourages higher spending, directly increasing your average order value. ### Reward Types Discounts can be a percentage or a fixed amount, applied as a managed coupon (default for new stores) or a negative fee. Free-gift tiers may offer several gifts and let the shopper choose. * **Free Shipping** — Show progress toward a free shipping threshold. Shipping cost is automatically zeroed when the goal is reached. * **Percentage Discount** — Automatically apply a percentage discount to the cart when the spending goal is met. * **Free Gift** — Automatically add a free product to the cart when the customer reaches the goal amount. ### Display-Only Mode (Show the Bar Without Changing the Cart Total) Prefer to use the bar purely as a marketing and motivation tool? Turn off **Apply rewards to cart** under **Advanced Reward Application**. The progress bar, milestone markers, and messages (for example, “Add $50 more for 10% off”) still display and update in real time, but the plugin will **not** apply any discount, free shipping, or free gift, and will **never modify the WooCommerce order total**. This is ideal when your store already applies its own discounts (such as a payment- method discount) and you want to avoid stacking or double-discounting — the bar stays informational only. ### Bar Styles * **Rounded** — Pill-shaped bar with smooth edges. * **Flat** — Clean, squared bar with no border radius. * **Striped** — Animated diagonal stripes for a more dynamic look. ### Celebration Animations When a customer reaches the goal, the bar can celebrate with one of four animations: * **Pulse** — A quick scale-up effect. * **Glow** — A pulsing glow around the bar. * **Bounce** — A playful bounce animation. * **Confetti** — Colorful confetti sparkles appear around the bar. ### Multi-Platform Support * **WooCommerce** — Classic cart, block cart, block checkout, mini-cart, and HPOS compatible. * **SureCart** — Native integration via Alpine.js event bridge. * **FluentCart** — Native integration via wp.hooks event bridge. The plugin auto-detects which eCommerce platform is active, or you can manually select one from the settings page. ### Full Customization * Bar and track colors, text colors, reached-state colors, empty-state colors. * Gradient fills with configurable direction (horizontal, diagonal, vertical). * Bar height, border radius, width, shadow, and border — all configurable. * Font size, font family, font weight, and text alignment. * Container padding, bar gap, and container background color. * Per-state display modes: show bar + text, bar only, text only, or hidden. * Per-state icons via emoji input or WordPress Media Library upload. ### Messages & Placeholders Customize the message shown at each stage using dynamic placeholders: * `{remaining}` — Amount still needed to reach the goal. * `{percent}` — Percentage of goal reached (0–100). * `{reward}` — The configured reward label. * `{goal}` — The goal amount with currency symbol. * `{total}` — Current cart subtotal with currency symbol. Three separate message templates: **empty cart**, **in-progress**, and **goal reached**. ### Dark Mode Softminal Cart Reward Progress Bar respects `prefers-color-scheme: dark` automatically. You can also configure custom dark mode colors for the bar, track, and text. ### RTL Support Full right-to-left language support with auto-detection or manual override (LTR / RTL). ### Currency Formatting Configure the currency symbol position (before/after), decimal places (0–2), and thousand separator (comma, dot, space, or none) independently from your eCommerce platform. ### Smart Cart Rules Control exactly which cart items count toward the reward goal — so the bar never promises a reward the store doesn’t intend to give: * **Exclude sale items** — Discounted products don’t count toward the goal. * **Only count specific categories** — Restrict goal progress to selected product categories (by slug or ID). * **Exclude categories** — Gift cards, deposits, bundles, or any category you choose never count. * **Exclude specific products** — Blocklist individual product IDs. * Free gifts added by the plugin itself never count toward the goal. Category and product rules apply to WooCommerce stores. ### Scheduling Optionally restrict the progress bar to a specific date range — useful for seasonal promotions, flash sales, or holiday campaigns. ### Accessibility The progress bar is built with proper ARIA attributes (`role="progressbar"`, `aria- valuenow`, `aria-valuemin`, `aria-valuemax`, `aria-label`) so it is fully usable by screen readers and assistive technologies. Animations respect `prefers-reduced- motion`. ### Product Suggestions Turn the gap into a sale: under the bar, show the products that get the shopper to the next reward, with a one-click **Add** button. Automatic price matching, category- based, or hand-picked — with the same Smart Cart Rules applied. ### Display Locations * **Cart, mini-cart and checkout** — the classic places. * **Product pages** — a bar beside the add-to-cart button that tells shoppers when the item they are looking at unlocks the next reward. * **Sticky site-wide bar** — pinned to the top or bottom of every page so the goal follows shoppers around the store. * **Block and shortcode** — the “Reward Progress Bar” block or `[cbpb_bar]` anywhere else. ### Shortcode Place the bar anywhere using the `[cbpb_bar]` shortcode. Works with the Block Editor( Gutenberg), Elementor, Divi, Bricks, and any other page builder that supports shortcodes. ### Developer Friendly * No custom database tables — all settings stored in `wp_options`. * Clean uninstall — all `cbpb_*` options are removed on plugin deletion. * CSS custom properties drive all styling — zero theme conflicts, no `!important`. * Fully namespaced PHP (`CartBoostPB\`) with PSR-4 autoloading. * REST API at `softminal-cart-reward-progress-bar/v1` with capability-based permission checks. * The admin app’s uncompiled source (`resources/`) and build tooling (`package. json`, `vite.config.js`, `build.sh`) are available in the public development repository: https://github.com/softminal/softminal-cart-reward-progress-bar * REST endpoint `GET /bar-state` and a `cbpb:updated` browser event expose live progress to themes and other plugins. `cbpb_sticky_bar_render` filter controls where the sticky bar appears; `cbpb_suggestions` filter adjusts the suggested products; `cbpb:suggestion-added` browser event fires after a one-click add. * Extensible via filters: `cbpb_subtotal` (adjust the subtotal that drives goal progress — e.g. for multi-currency conversion), `cbpb_reward_tiers` (modify reward tiers at runtime — e.g. convert tier amounts into the visitor’s currency), and` cbpb_apply_rewards` (control whether rewards are applied to the cart, for display- only mode). ### 100% Free Every feature is included at no cost. There is no premium tier, no feature gating, and no upsells. ## Screenshots [⌊Live progress bar on the WooCommerce cart page — shows how close the shopper is to the next reward, with milestone markers for each tier.⌉⌊Live progress bar on the WooCommerce cart page — shows how close the shopper is to the next reward, with milestone markers for each tier.⌉[ Live progress bar on the WooCommerce cart page — shows how close the shopper is to the next reward, with milestone markers for each tier. [⌊Goal reached — the bar celebrates and confirms the unlocked reward.⌉⌊Goal reached— the bar celebrates and confirms the unlocked reward.⌉[ Goal reached — the bar celebrates and confirms the unlocked reward. [⌊Reward Tiers editor — stack multiple reward milestones (free shipping, discount, free gift), each with its own threshold, label, and marker color.⌉⌊Reward Tiers editor — stack multiple reward milestones (free shipping, discount, free gift), each with its own threshold, label, and marker color.⌉[ Reward Tiers editor — stack multiple reward milestones (free shipping, discount, free gift), each with its own threshold, label, and marker color. [⌊Appearance settings — bar style, colors, gradient, dimensions, and spacing, with a real-time live preview of the bar in every state.⌉⌊Appearance settings — bar style, colors, gradient, dimensions, and spacing, with a real-time live preview of the bar in every state.⌉[ Appearance settings — bar style, colors, gradient, dimensions, and spacing, with a real-time live preview of the bar in every state. [⌊Advanced settings — the "Apply rewards to cart" toggle turns the bar into a display- only progress indicator, plus Smart Cart Rules, currency formatting, and scheduling.⌉⌊ Advanced settings — the "Apply rewards to cart" toggle turns the bar into a display- only progress indicator, plus Smart Cart Rules, currency formatting, and scheduling .⌉[ Advanced settings — the “Apply rewards to cart” toggle turns the bar into a display- only progress indicator, plus Smart Cart Rules, currency formatting, and scheduling. [⌊Messages settings — customize text, icons, and dynamic placeholders for the empty, in-progress, and reached states.⌉⌊Messages settings — customize text, icons, and dynamic placeholders for the empty, in-progress, and reached states.⌉[ Messages settings — customize text, icons, and dynamic placeholders for the empty, in-progress, and reached states. [⌊Product Suggestions — show shoppers the products that get them to the next reward, with one-click add to cart. Choose automatic price matching or hand-picked products, where the row appears, and the layout.⌉⌊Product Suggestions — show shoppers the products that get them to the next reward, with one-click add to cart. Choose automatic price matching or hand-picked products, where the row appears, and the layout.⌉[ Product Suggestions — show shoppers the products that get them to the next reward, with one-click add to cart. Choose automatic price matching or hand-picked products, where the row appears, and the layout. [⌊Display Locations — pick where the bar appears: cart page, mini-cart, checkout, product pages, a site-wide sticky bar, or anywhere via the [cbpb_bar] shortcode.⌉⌊ Display Locations — pick where the bar appears: cart page, mini-cart, checkout, product pages, a site-wide sticky bar, or anywhere via the [cbpb_bar] shortcode.⌉[ Display Locations — pick where the bar appears: cart page, mini-cart, checkout, product pages, a site-wide sticky bar, or anywhere via the [cbpb_bar] shortcode. ## Blocks This plugin provides 1 block. * Reward Progress Bar Live cart progress toward your reward tiers. Updates as the cart changes. ## Installation #### Automatic Installation 1. Log in to your WordPress admin dashboard. 2. Go to **Plugins > Add New**. 3. Search for **Softminal Cart Reward Progress Bar**. 4. Click **Install Now** and then **Activate**. 5. Navigate to **Softminal Rewards Bar** in the admin sidebar to configure your settings. #### Manual Installation 1. Download the plugin ZIP file from WordPress.org. 2. Log in to your WordPress admin dashboard. 3. Go to **Plugins > Add New > Upload Plugin**. 4. Choose the downloaded ZIP file and click **Install Now**. 5. Click **Activate** after installation completes. 6. Navigate to **Softminal Rewards Bar** in the admin sidebar to configure your settings. #### Manual Installation via FTP 1. Download and extract the plugin ZIP file. 2. Upload the `softminal-cart-reward-progress-bar` folder to `/wp-content/plugins/` on your server. 3. Log in to your WordPress admin dashboard and go to **Plugins**. 4. Find **Softminal Cart Reward Progress Bar** in the list and click **Activate**. 5. Navigate to **Softminal Rewards Bar** in the admin sidebar to configure your settings. ## FAQ ### Does Softminal Cart Reward Progress Bar work with the WooCommerce block-based cart and checkout? Yes. Softminal Cart Reward Progress Bar fully supports both the classic cart/checkout shortcodes and the newer block-based cart and checkout pages. The progress bar updates in real time in both setups. ### Can I customize the colors and messages? Yes. You can change the bar color, background color, text color, and messages for each state (empty cart, in-progress, goal reached). Messages support dynamic placeholders such as `{remaining}`, `{goal}`, `{percent}`, `{reward}`, and `{total}`. ### Can I use Softminal Cart Reward Progress Bar with more than one eCommerce platform? Softminal Cart Reward Progress Bar auto-detects which eCommerce plugin is active( WooCommerce, SureCart, or FluentCart) and uses the appropriate adapter. You can also manually select the platform in the settings. ### Will the progress bar slow down my site? No. Softminal Cart Reward Progress Bar is lightweight and loads minimal CSS and JS only on pages where the bar is displayed. The bar updates via AJAX or platform- native events without full page reloads. No custom database tables are created. ### Is Softminal Cart Reward Progress Bar compatible with HPOS (High-Performance Order Storage)? Yes. Softminal Cart Reward Progress Bar declares full compatibility with WooCommerce HPOS. ### How do I display the bar using a shortcode? Use `[cbpb_bar]` in any post, page, or widget area. The bar will display the current cart progress toward the configured reward goal wherever the shortcode is placed. ### Does the bar work in the mini-cart / drawer cart? Yes. Enable “Mini-Cart” in the Display Locations settings. The bar renders in a compact layout optimized for mini-cart widgets. ### Does Softminal Cart Reward Progress Bar set any cookies or collect personal data? No. Softminal Cart Reward Progress Bar does not collect, store, or transmit any personal data. It reads cart totals from your eCommerce platform to calculate progress and stores plugin settings in the WordPress options table. No cookies are set and no external services are contacted. ### Do I need WooCommerce to use this plugin? Not necessarily. Softminal Cart Reward Progress Bar also works with SureCart and FluentCart. You need at least one of these three eCommerce plugins active. ### Can I exclude sale items, gift cards, or certain products from the goal calculation? Yes. Under **Advanced Smart Cart Rules** you can exclude sale items, restrict the goal to specific product categories, exclude categories entirely, or blocklist individual product IDs. The bar, messages, and reward unlocks all use the filtered subtotal, so shoppers only see progress for items that actually qualify. Category and product rules apply to WooCommerce stores. ### Can I show the reward bar without actually applying the discount or reward to the cart? Yes. Go to **Advanced Reward Application** and turn off **Apply rewards to cart**. The bar, milestone markers, and messages continue to display and update, but the plugin will not apply any discount, free shipping, or free gift, and it will not modify the cart or order total. Use this when you only want the visual progress bar, or when your store already applies its own discount (for example, a bank-transfer or payment-method discount) and you want to avoid stacking two discounts on the same order. ### Does the plugin work with multi-currency stores? The bar always displays your platform’s active currency symbol. If you use a multi- currency plugin that converts cart prices, use the `cbpb_reward_tiers` filter to convert each tier’s goal amount into the visitor’s currency (or the `cbpb_subtotal` filter to normalize the subtotal). A small code snippet in your theme or a snippets plugin is all that’s needed. ### Can I schedule the bar to show only during a sale or promotion? Yes. Enable the scheduling option in the Advanced settings and set a start and end date. The bar will only appear within that date range. ### Is there a premium version? No. Softminal Cart Reward Progress Bar is 100% free with all features included. There is no pro tier, no feature gating, and no upsells. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Softminal Cart Reward Progress Bar” is open source software. The following people have contributed to this plugin. Contributors * [ Softminal ](https://profiles.wordpress.org/softminal/) [Translate “Softminal Cart Reward Progress Bar” into your language.](https://translate.wordpress.org/projects/wp-plugins/softminal-cart-reward-progress-bar) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/softminal-cart-reward-progress-bar/), check out the [SVN repository](https://plugins.svn.wordpress.org/softminal-cart-reward-progress-bar/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/softminal-cart-reward-progress-bar/) by [RSS](https://plugins.trac.wordpress.org/log/softminal-cart-reward-progress-bar/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.2.0 (01 October, 2026) * New: Sticky site-wide bar (Locations Sticky bar). A compact bar pinned to the top or bottom of every page, with “show when” rules (cart has items / goal not reached / always), device targeting, a close button with a configurable snooze, and automatic hiding on the cart and checkout pages. Updates live as the cart changes, including block-theme shop grids. * New: Product-page bar (Locations Product page). Shows above or below the add- to-cart form; when the viewed product alone unlocks the next reward the message switches to a configurable “Add this item to unlock {next_reward}!” variant with a `{product_price}` placeholder. * New: Product suggestions (Suggestions tab). While the goal is not yet reached, a short “Add one of these to unlock {next_reward}” list appears under the bar with products priced around the remaining amount and a one-click Add button. Automatic price matching, specific categories, or hand-picked products; honors Smart Cart Rules and skips items already in the cart. WooCommerce stores. * New: Coupon-based discounts (Advanced Reward Application “Apply discounts as”). Discount tiers can be applied as plugin-managed WooCommerce coupons, so the reward shows up correctly in order emails, refunds and reports. Managed coupons are hidden from your coupon list and cannot be typed in by shoppers. Existing stores keep the negative-fee method they already use; new installs default to coupons. * New: Fixed-amount discount tiers (“$10 off at $100”) alongside percentage tiers. * New: Free gift tiers can list several gift products; the shopper picks one in a small chooser when the tier unlocks (or the first option is added automatically— your choice). * New: Optional sync of free-shipping tier thresholds with the WooCommerce Free Shipping minimum of the shopper’s shipping zone (Advanced Reward Application). * New: “Reward Progress Bar” block for the block editor (WooCommerce category) with a live server-side preview, as an alternative to the `[cbpb_bar]` shortcode. * Improvement: Live bar refreshes use a dedicated REST endpoint (`GET /softminal- cart-reward-progress-bar/v1/bar-state`) that is faster than admin-ajax and sends` Cache-Control: no-store`; admin-ajax remains as an automatic fallback. * Improvement: Block cart and block mini-cart receive the bar state inside the WooCommerce Store API cart response (`extensions.cbpb`), so no extra request is needed to detect changes. * Improvement: The bar now also refreshes after add-to-cart from block-theme shop grids and the Interactivity API product button. * Improvement: Admin settings UI polish — consistent form controls, grouped color cards, clearer Locations and Reward Tiers panels, and each settings section now has its own URL (e.g. `#/settings/appearance`) so reloads and links land on the same tab. * Fix: Free gift tiers now reliably add the gift when the threshold is reached. The gift logic ran at a point where WooCommerce had reset its totals, so the cart subtotal read as zero and the gift was never added on many setups. * Developer: New `cbpb:updated` browser event and `window.cbpb` API (`refresh()`,` refreshAll()`, `getState()`, `show()`, `dismissSticky()`, `openGiftChooser()`);` cbpb:suggestion-added` and `cbpb:gift-chosen` events. * Developer: New PHP filters `cbpb_bar_state`, `cbpb_reward_method`, `cbpb_suggestions`,` cbpb_sticky_bar_render`, `cbpb_watch_store_api`; new REST routes `GET /bar-state` and `POST /gift-choice`. * Compatibility: Declares WooCommerce “tested up to 11.2”. #### 1.1.3 (01 September, 2026) * New: “When multiple tiers unlock” setting (Advanced Reward Application) to control reward stacking. “Highest tier only” (the new default) applies just the top unlocked tier of each reward type, so a cart that passes several milestones no longer receives multiple discounts added together. Choose “Stack all unlocked tiers” to keep the previous cumulative behavior. * Fix: Carts that qualified for more than one discount tier previously stacked every tier’s discount at once (e.g. 1% + 2% + 3%), reducing the order total more than intended. Only the highest unlocked discount now applies by default. Applies to WooCommerce stores using multiple discount tiers. #### 1.1.2 (31 August, 2026) * Fix: The reward bar now updates live on block-based cart and mini-cart (block themes / WooCommerce Cart & Checkout blocks). Previously the bar only refreshed on a full page reload because these carts use the Store API and do not fire the legacy fragment events the bar relied on. The bar now subscribes to the WooCommerce Store API cart data and refreshes in place as items and quantities change. * Fix: The bar could stay hidden when a performance plugin’s “Delay JavaScript” option deferred the script past page load. Added a reveal failsafe so the bar always becomes visible, and it now reveals correctly even when its script runs after the page has finished loading. * Improvement: Classic shop/product AJAX add-to-cart now also refreshes the bar via the `added_to_cart` / `removed_from_cart` events. #### 1.1.1 (30 August, 2026) * New: “Apply rewards to cart” setting (Advanced Reward Application) — turn it off to use the bar as a display-only marketing tool. The bar, markers, and messages still show, but no discount, free shipping, or free gift is applied and the cart/ order total is never modified. Ideal for stores that already run their own discounts and want to avoid stacking. Defaults to on, so existing stores are unchanged. * Developer: New `cbpb_apply_rewards` filter to toggle reward application programmatically. * Fix: Notification toasts in the admin no longer show a stray list marker and now clear the admin bar with a smooth slide animation. #### 1.1.0 (02 July, 2026) * New: Smart Cart Rules — control which cart items count toward the reward goal. * New: “Only Count These Categories” and “Exclude Categories” rules (WooCommerce)— restrict goal progress by product category, using slugs or IDs. * New: “Exclude Products” rule (WooCommerce) — blocklist individual product IDs from the goal calculation. * Fix: The “Exclude Sale Items” setting is now enforced — previously it was saved but sale items still counted toward the goal. * Improvement: Free gifts added by the plugin no longer count toward the goal subtotal. * Developer: New `cbpb_subtotal` filter — adjust the subtotal that drives goal progress (multi-currency, custom eligibility) on all three platforms. * Developer: New `cbpb_reward_tiers` filter — modify reward tiers at runtime (e. g. convert tier amounts for multi-currency stores). #### 1.0.1 (17 June, 2026) * New: Multi-tier rewards — stack multiple reward milestones (free shipping, discount, free gift) on a single progress bar. * New: Milestone markers on the bar show each reward threshold and light up as shoppers unlock them. * New: “Reward Tiers” admin editor with add/remove tiers, per-tier reward type, label, and marker color, plus a tier-aware live preview. * New: Message placeholders {next_reward} and {unlocked_count}. * Improvement: Fully backward compatible — existing single-goal stores keep working unchanged. #### 1.0.0 (03 May, 2026) * Initial release. ## Meta * Version **1.2.0** * Last updated **6 kúnler ago** * Active installations **10+** * WordPress version ** 5.8 or higher ** * Tested up to **7.1.3** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/softminal-cart-reward-progress-bar/) * Tags * [cart](https://kaa.wordpress.org/plugins/tags/cart/)[free shipping bar](https://kaa.wordpress.org/plugins/tags/free-shipping-bar/) [progress bar](https://kaa.wordpress.org/plugins/tags/progress-bar/)[reward](https://kaa.wordpress.org/plugins/tags/reward/) [woocommerce](https://kaa.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://kaa.wordpress.org/plugins/softminal-cart-reward-progress-bar/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/softminal-cart-reward-progress-bar/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/softminal-cart-reward-progress-bar/reviews/) ## Contributors * [ Softminal ](https://profiles.wordpress.org/softminal/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/softminal-cart-reward-progress-bar/)