Skip to content
WPPoland Documentation

Getting started

Most shops can show the bar in a few minutes. Nudge reads your free-shipping goal automatically — install, enable, pick placements.

Before you start

Section titled “Before you start”
  • WordPress 6.5 or newer
  • WooCommerce active (a free-shipping method helps, but is optional)
  • PHP 8.1 or newer

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Nudge from the plugin directory (when live on WordPress.org) or upload the nudge folder to /wp-content/plugins/.
  3. Activate the plugin.

First configuration

Section titled “First configuration”

Open WooCommerce → Nudge in wp-admin:

  • Enable bar — master switch.
  • Threshold mode — Automatic reads the minimum order amount from your enabled free-shipping method (smallest across zones); Manual lets you set a fixed amount. Automatic falls back to the manual amount when no qualifying method exists.
  • Placements — cart, checkout, or both; classic templates and Cart/Checkout Blocks are supported.
  • Messages — progress message with the {amount} token, plus a separate success message when the goal is reached.
  • Colours — CSS custom properties, dark-mode aware, set in the live preview.

Verify on the storefront

Section titled “Verify on the storefront”
  1. Open the Cart — the bar should show the remaining amount to free shipping.
  2. Add a product — the bar should re-render live and animate toward the goal.
  3. Cross the threshold — the bar should switch to the success message.
  4. Empty the cart or remove the goal — the bar should hide itself rather than show a broken state.

The [nudge_bar] shortcode

Section titled “The [nudge_bar] shortcode”
[nudge_bar]

Place the bar anywhere with [nudge_bar] — any page, post or widget. It renders the current cart’s progress and hides itself when the cart is empty or no goal is set.

Free vs PRO

Section titled “Free vs PRO”

The free edition covers automatic or manual threshold, live updates, cart/checkout/shortcode placement, customisable messages and colours.

Nudge PRO (planned) adds per-zone goals, tiered rewards, gift thresholds and conversion analytics — not the basic progress bar.

Need help?

Section titled “Need help?”