外掛標籤
開發者團隊
② 後台搜尋「Rankd Free Shipping Progress Bar」→ 直接安裝（推薦）
原文外掛簡介
This plugin shows a free shipping progress message on your WooCommerce store. When a customer’s cart is below your threshold, they see how much more they need to spend. When they hit it, the message updates to confirm they’ve qualified. The message refreshes as items are added or removed without a page reload.
You can drop it on any page using the shortcode [rankd_free_shipping], or turn on auto-inject to have it appear automatically at the top of your cart and checkout pages. Settings are under WooCommerce → Settings → Free Shipping Progress.
What it does
Auto-injects on the cart page, checkout page, or both — no shortcode needed
Shortcode [rankd_free_shipping] works on any page, widget area, or theme template
Updates the message and progress bar as the cart changes, including on block-based themes
Full appearance control — colors, font, font size, and border radius via an in-page Appearance tab with live preview and WCAG AA contrast checking
Progress bar is included by default and can be hidden with a single CSS rule
Threshold amount is configurable
Supports an optional coupon code — useful if your free shipping requires one
Message text is customizable, with {amount} and {coupon} merge tags
Role exclusions let you hide the message from specific user roles
Developer filters for threshold, messages, and subtotal calculation
CSS class reference built into the Appearance tab
Where to find the settings
After activating, go to WooCommerce → Settings → Free Shipping Progress. The page has two in-page tabs: Settings for the threshold, messages, coupon, and role exclusions, and Appearance for colors, fonts, and styling.
Developer Filters
For developers who need to customize behavior beyond the settings page, the following filters are available:
rankd_fs_threshold — filters the threshold amount before comparison. Receives the saved threshold as a float.
rankd_fs_subtotal — filters the cart subtotal used for the comparison. Receives `WC()->cart->get_cart_contents_total()` by default. Useful if your store needs a different calculation (e.g. including tax, or excluding certain product categories).
rankd_fs_msg_notice / `rankd_fs_msg_success` / `rankd_fs_msg_coupon_line` — filter the raw message strings before merge tags are processed. Each receives the saved message text.
Example:
add_filter( 'rankd_fs_threshold', function( $threshold ) {
return is_user_logged_in() ? 75 : 50;
});
Styling
Class
Element
.rankd-fs-wrapper
Outer div (both states)
.rankd-fs-notice
Outer div — threshold not met
.rankd-fs-success
Outer div — threshold met
.rankd-fs-message
Message text span
.rankd-fs-amount
Currency amount span
.rankd-fs-coupon-code
Coupon code span
.rankd-fs-coupon-line
Coupon line beneath success message
.rankd-fs-bar-track
Progress bar background track
.rankd-fs-bar-fill
Progress bar filled portion
