Rankd Free Shipping Progress Bar
| 开发者 |
coolhuntersgt
rankd.site |
|---|---|
| 更新时间 | 2026年8月14日 23:32 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
[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
安装:
- Upload the
rankd-free-shipping-progress-barfolder to/wp-content/plugins/, or install via Plugins → Add New → Upload Plugin - Activate the plugin
- Go to WooCommerce → Settings → Free Shipping Progress
- Set your threshold amount and customize your messages
- Enable auto-inject or place
[rankd_free_shipping]on your site
屏幕截图:
常见问题:
I activated the plugin but nothing is showing. Why?
Go to WooCommerce → Settings → Free Shipping Progress and either enable one of the Auto-inject options, or place the shortcode [rankd_free_shipping] somewhere on your site.
Does the progress bar update live?
Yes, on all pages. Classic cart/checkout responds immediately to WooCommerce cart update events. Block-based themes and other contexts update via a polling loop every 2.5 seconds.
How do I customize the colors and fonts?
Go to WooCommerce → Settings → Free Shipping Progress and click the Appearance tab. You'll find color pickers for all states, font family, font size, and border radius controls, with a live preview that updates as you make changes.
My store has multiple shipping zones with different minimums. Will this work?
Not fully. This plugin shows one threshold to all visitors. If your zones have the same threshold there's no problem. If they differ significantly, a geo-aware plugin will serve you better for this feature.
How do I hide the progress bar and show text only?
Add .rankd-fs-bar-track { display: none; } to Appearance → Customize → Additional CSS.
Does this work with Elementor, Divi, or Beaver Builder?
Yes. The plugin outputs standard HTML and CSS with body-scoped selectors to handle specificity from page builders. The font selector on the Appearance tab detects fonts already registered by your page builder.
Does this work with caching plugins?
Yes. The progress message itself is excluded from static page caching by design — it's refreshed via AJAX after page load, so even on a fully cached page the displayed amount will update to reflect the current cart. If your host or caching plugin caches AJAX/admin-ajax.php responses (uncommon, but some aggressive configurations do), you may need to exclude admin-ajax.php requests from caching for live updates to work correctly.
Does the threshold account for tax?
The threshold compares against your cart's subtotal before tax (get_cart_contents_total()), which matches how WooCommerce's own free shipping zone settings calculate eligibility in most configurations. If your store has an unusual tax setup where this doesn't match, the rankd_fs_subtotal filter (see Developer Filters below) lets you override the calculation.
Is this compatible with High-Performance Order Storage (HPOS)?
Yes. The plugin declares HPOS compatibility and doesn't interact with order data directly — it only reads the current cart session, so HPOS has no effect on its behavior.
更新日志:
- Tested up to WordPress 7.1.
- Fixed: version constant was out of sync with the plugin header, causing assets to cache-bust under the wrong version number. = 1.1.2 = (8/10/2026) Tested up to WooCommerce 11.0
- Fixed: Appearance colors and font settings not applying on the front end.
wp_add_inline_style()was called onwp_headbefore the style handle was registered; moved towp_enqueue_scriptsat priority 20 to ensure correct hook order.
- New: Appearance tab. A full visual customization panel — color pickers for every state (background, border, text, and progress bar fill for both the "Almost There" and "Qualified" messages), font family selector that automatically detects fonts already registered by your theme and page builder (Elementor Pro kit fonts, Google Fonts, WP Fonts API), font size with px/em/rem units, and separate border radius controls for the message box and the progress bar itself.
- New: Live preview. Both message states render side by side directly on the Appearance tab and update instantly as you adjust any setting — no need to save and check the front end.
- New: WCAG AA contrast checking. Each preview state shows a pass/fail badge with the calculated contrast ratio, so it's easy to catch low-contrast color combinations before they reach customers.
- New: Reset to Defaults button restores all Appearance settings in one click.
- New: Developer filters —
rankd_fs_threshold,rankd_fs_subtotal,rankd_fs_msg_notice,rankd_fs_msg_success, andrankd_fs_msg_coupon_linefor advanced customization. See the Developer Filters section above. - Fixed: settings page now extends
WC_Settings_Pagefor fully reliable saving — previous versions could lose settings under certain WooCommerce configurations. - Fixed: setup reminder notice is now dismissible.
- Improved: Google Fonts detection now correctly preserves multi-word font names (e.g. "Open Sans", "Roboto Slab").
- Initial release.