Title: Shiplume &#8211; Shipping Progress Bar for WooCommerce
Author: Mariusz Szatkowski
Published: <strong>2026 年 9 月 30 日</strong>
Last modified: 2026 年 10 月 2 日

---

搜尋外掛

![](https://ps.w.org/shiplume/assets/banner-772x250.png?rev=3720411)

![](https://ps.w.org/shiplume/assets/icon-256x256.png?rev=3720396)

# Shiplume – Shipping Progress Bar for WooCommerce

 由 [Mariusz Szatkowski](https://profiles.wordpress.org/motylanogha/) 開發

[下載](https://downloads.wordpress.org/plugin/shiplume.1.1.7.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/shiplume/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/shiplume/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/shiplume/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/shiplume/#developers)

 [技術支援](https://wordpress.org/support/plugin/shiplume/)

## 外掛說明

Shiplume shows shoppers how far their cart is from your free-shipping threshold 
and
 how much more they need to add to reach it. The message updates as the cart
changes, so “free shipping over $50” stops being fine print and becomes a number
the customer can act on.

By default the threshold comes straight from WooCommerce. Shiplume looks at your

enabled free-shipping methods across all shipping zones and uses the lowest minimum
order amount it finds, so you don’t maintain the figure in two places. If you’d 
rather set it yourself, switch to Manual mode and type a fixed amount; that amount
is also used as a fallback when Automatic mode finds no qualifying method.

When there’s nothing useful to show (the bar is disabled, the cart is empty, or 
no
 threshold is configured) Shiplume renders nothing instead of an empty or always-
finished bar.

#### Documentation and links

 * **Documentation**: [plogins.com/plogins-nudge/docs/](https://plogins.com/plogins-nudge/docs/)
 * **Plugin page**: [plogins.com/plogins-nudge/](https://plogins.com/plogins-nudge/)
 * **Source code**: [github.com/wppoland/plogins-nudge](https://github.com/wppoland/plogins-nudge)
 * **Bug reports and feature requests**: [github.com/wppoland/plogins-nudge/issues](https://github.com/wppoland/plogins-nudge/issues)

#### What it does

 * Reads the free-shipping threshold automatically from your active WooCommerce
   
   free-shipping methods, or takes a fixed amount you set by hand.
 * Re-renders with the cart on the classic Cart and Checkout pages (the ones
    built
   with the `[woocommerce_cart]` and `[woocommerce_checkout]` shortcodes). A small
   script (no jQuery of its own) animates the width between updates.
 * Exposes a real `role="progressbar"` with `aria-valuenow`/`min`/`max` and a
    readable
   text message for screen readers; honours `prefers-reduced-motion`.
 * Reserves the bar’s height before paint, so adding it doesn’t shift the layout.
 * Styles the bar with `--nudge-*` CSS custom properties and adapts to dark colour
   
   schemes, so themes can recolour it without editing markup.
 * Lets you write the progress and success messages, with an `{amount}` token in
   
   either one for the remaining total.
 * Ships a POT file, removes its options on uninstall, and declares HPOS
    compatibility.

Source code and bug reports live on GitHub: [github.com/wppoland/plogins-nudge](https://github.com/wppoland/plogins-nudge)

### External Services

Shiplume does not connect to any external service. It does not send analytics, register
a licence, load remote fonts or scripts, or make any HTTP request off your server.
Everything it needs (your free-shipping threshold and cart totals) comes from WooCommerce
on the same site, and the bar’s stylesheet and small animation script are served
from the plugin folder, not a CDN. The only data Shiplume stores is two WordPress
options on your own database (`nudge_settings` for your configuration and `nudge_db_version`
for upgrades), both removed when you delete the plugin.

### Translations

Shiplume is fully translatable and ships the `shiplume.pot` template. Translations
are delivered by WordPress.org language packs from translate.wordpress.org, which
is where Polish, German and Spanish are being contributed; the package itself carries
no compiled translation files.

## 螢幕擷圖

[⌊The cart with one progress bar above the totals, showing how much more to add 
for free shipping.⌉⌊The cart with one progress bar above the totals, showing how
much more to add for free shipping.⌉[

The cart with one progress bar above the totals, showing how much more to add for
free shipping.

[⌊The Shiplume settings screen: where the bar shows, the free-shipping threshold
and the messages, with the PRO features listed alongside.⌉⌊The Shiplume settings
screen: where the bar shows, the free-shipping threshold and the messages, with 
the PRO features listed alongside.⌉[

The Shiplume settings screen: where the bar shows, the free-shipping threshold and
the messages, with the PRO features listed alongside.

[⌊The same bar at the top of the checkout.⌉⌊The same bar at the top of the checkout
.⌉[

The same bar at the top of the checkout.

## 安裝方式

 1. Upload the plugin to `/wp-content/plugins/shiplume`, or install via Plugins > Add
    New.
 2. Activate it. WooCommerce must be active.
 3. Go to **WooCommerce > Shiplume**, enable the bar, and choose where it shows.

## 常見問題集

### Does it require WooCommerce?

Yes. Shiplume does nothing until WooCommerce is active.

### Where does the free-shipping amount come from?

In Automatic mode, Shiplume reads the minimum order amount from your enabled
 WooCommerce
free-shipping methods and uses the smallest one across your shipping zones. In Manual
mode you set a fixed amount yourself. If Automatic mode finds no method with a minimum
order amount, it uses the manual amount instead.

### What shows when no free-shipping goal is configured?

Nothing. Rather than render an empty or always-complete bar, Shiplume skips output

entirely until there’s a real threshold to count down to.

### Does it work with the Cart and Checkout blocks?

Not yet. The bar renders on the classic Cart and Checkout pages, the ones built

with the `[woocommerce_cart]` and `[woocommerce_checkout]` shortcodes. It is safe
alongside the blocks and declares Cart/Checkout Blocks compatibility, but it draws
nothing inside them. If your pages use the blocks, the Shiplume settings screen 
tells you so next to the placement checkboxes.

### Can I change the wording and colours?

Yes. The progress and success messages are editable on the settings screen, and

the bar’s colours and sizing are `--nudge-*` CSS custom properties your theme can
override.

### Does this plugin work on WordPress Multisite?

Yes. This plugin is compatible with WordPress Multisite. Network activate it or 
activate it on individual sites; each site keeps its own settings and data.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈Shiplume – Shipping Progress Bar for WooCommerce〉的開發
相關工作。

參與者

 *   [ Mariusz Szatkowski ](https://profiles.wordpress.org/motylanogha/)

〈Shiplume – Shipping Progress Bar for WooCommerce〉外掛目前已有 1 個本地化語言版本。
感謝[全部譯者](https://translate.wordpress.org/projects/wp-plugins/shiplume/contributors)
為這個外掛做出的貢獻。

[將〈Shiplume – Shipping Progress Bar for WooCommerce〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/shiplume)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/shiplume/)、查看
[SVN 存放庫](https://plugins.svn.wordpress.org/shiplume/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/shiplume/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/shiplume/)。

## 變更記錄

#### 1.1.7

 * Fixed: a store with no free-shipping method no longer shows “Add X more to get
   free shipping!”. The manual amount defaulted to 50, so Automatic mode fell back
   to a goal WooCommerce never honours. The manual amount now starts at 0; a store
   that saved its settings keeps the amount it saved.
 * Fixed: when the free-shipping method has “Apply minimum order rule before coupon
   discount” ticked, progress is measured before coupons, as WooCommerce does. The
   bar used to ask for more while WooCommerce already offered free shipping.
 * Fixed: the progress bar reaches screen readers with its value. aria-valuenow,
   aria-valuemin and aria-valuemax were stripped from the output.
 * Fixed: the bar animates again after the cart or checkout updates. The script 
   listened natively for events WooCommerce fires through jQuery, which never reached
   it.

#### 1.1.6

 * Fixed: the bar showed twice on the classic cart and checkout, once above the 
   totals and once inside them. On checkout a copy was added on every refresh. There
   is now one bar per page, and the checkout bar still updates when a coupon changes
   the total.
 * Fixed: the bar’s placement class and data attribute printed “Array” instead of
   cart or checkout.

#### 1.1.5

 * Display name is now Shiplume – Shipping Progress Bar for WooCommerce. The slug,
   settings and hooks are unchanged.

#### 1.1.4

 * The bar markup is escaped with wp_kses_post() where it is printed, instead of
   relying on the template alone.

#### 1.1.3

 * The upgrade notice’s “Coming soon” and “Get notified” labels are English source
   strings for every language; Polish sites used to get their own Polish source 
   text, which translators in other languages then saw untranslated.

#### 1.1.2

 * Renamed to Shiplume, a plain English name in place of the Esperanto one. The 
   text domain and the plugin folder follow the name; the stored settings, options
   and every hook are unchanged.

#### 1.1.1

 * The sidebar upgrade promo now follows the same dismissal as the banner. Dismissing
   the banner used to leave a full-height advert on the settings screen for good,
   which is not what the WordPress.org guideline on upgrade prompts means by used
   with moderation.

#### 1.1.0

 * Renamed to Instigo. The WordPress.org review team asks a plugin name to lead 
   with a distinctive, coined identifier rather than a generic descriptive word.
   Instigo is Esperanto for an urging. The text domain follows the name; the stored
   data, the settings and every hook are unchanged.

#### 1.0.11

 * Fixed: the PRO upgrade promo kept selling to people who had already bought the
   paid edition. Only the banner could be dismissed, so the sidebar promo and the
   locked feature cards followed a paying customer around for good. The promo now
   checks whether the paid edition is active and steps aside when it is.
 * Fixed: arrow glyphs in the admin menu paths, and in the strings handed to translators.
   An arrow inside a translatable string makes the glyph every translator’s problem
   and changes the layout in any locale that drops it.

#### 1.0.10

 * Fixed: deleting the plugin left the per-user “dismiss” flag from the PRO notice
   in the database. Uninstall now removes it for every user, not just the one who
   dismissed it.

#### 1.0.9

 * Fixed the two bar messages being stuck in English on a translated shop. “Add {
   amount} more to get free shipping!” and “You have unlocked free shipping!” were
   plain strings in a config file, not translatable strings, so they never reached
   the translation template and no language pack could ever replace them. They are
   translatable now, so the bar follows the site language as soon as a translation
   exists, without touching the settings. Translations come as WordPress.org language
   packs rather than in this download, so the bar stays English until a pack is 
   published. Your own wording, if you typed one, is left exactly as you wrote it.

#### 1.0.8

 * Renamed to Plogins Nudge – Free Shipping Bar for WooCommerce so the name leads
   with the brand rather than a generic word, which is what the WordPress.org plugin
   review team asks for. The plugin slug is unchanged.

#### 1.0.7

 * Tested against WordPress 7.1. Verified by activating this build on a clean 7.1
   install with WooCommerce 11.1, not by editing the header.

#### 1.0.6

 * Fixed the PRO promo on the settings screen quoting a price in PLN. PRO is priced
   and charged in EUR, so an admin on a Polish site was shown a zloty amount and
   then billed in euro, and the zloty figure was a fixed conversion that drifted
   from the real charge as the rate moved. The promo now shows the euro price that
   is actually taken.

#### 1.0.5

 * The settings screen now warns you when your cart or checkout page is built with
   the WooCommerce Cart or Checkout block, where the bar cannot appear, instead 
   of leaving the placement box ticked with nothing showing on the storefront.
 * The `{amount}` token now works in the success message too, so it no longer reaches
   shoppers as literal text.
 * Corrected the plugin description: the bar renders on the classic cart and checkout
   pages, not inside the Cart and Checkout blocks.

#### 1.0.3

 * Translations: completed Polish, German and Spanish for the PRO upgrade panel.

#### 1.0.2

 * Added bundled Polish, German and Spanish translations for the plugin interface.

#### 1.0.1

 * First stable release.

#### 0.1.4

 * Renamed to Plogins Nudge for WooCommerce for a more distinctive plugin name.

#### 0.1.3

 * `nudge/bar_rendered` action and `data-nudge-placement` attribute for PRO analytics
   beacons.

#### 0.1.2

 * `nudge/bar_context` filter so PRO can adjust progress, messages and tier markers.

#### 0.1.1

 * `nudge/threshold` filter and `ThresholdResolver::zoneThreshold()` for PRO per-
   zone goals.

#### 0.1.0

 * First release: free-shipping progress bar for the cart and checkout, with an 
   automatic or manual threshold, live updates as the cart changes, editable messages,
   dark-mode and reduced-motion support, and a settings screen under WooCommerce
   > Nudge.

## 中繼資料

 *  版本 **1.1.7**
 *  最後更新 **10 小時前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 6.5 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.1.2**
 *  PHP 版本需求 ** 8.1 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/shiplume/) 及 [Polish](https://pl.wordpress.org/plugins/shiplume/).
 *  [將這個外掛本地化為你的母語版本](https://translate.wordpress.org/projects/wp-plugins/shiplume)
 * 標籤:
 * [cart](https://tw.wordpress.org/plugins/tags/cart/)[conversions](https://tw.wordpress.org/plugins/tags/conversions/)
   [free shipping](https://tw.wordpress.org/plugins/tags/free-shipping/)[progress bar](https://tw.wordpress.org/plugins/tags/progress-bar/)
   [woocommerce](https://tw.wordpress.org/plugins/tags/woocommerce/)
 *  [進階檢視](https://tw.wordpress.org/plugins/shiplume/advanced/)

## 評分

這個項目尚無任何評論記錄。

[撰寫評分](https://wordpress.org/support/plugin/shiplume/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/shiplume/reviews/)

## 參與者

 *   [ Mariusz Szatkowski ](https://profiles.wordpress.org/motylanogha/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/shiplume/)