=== Gatemi Free Shipping Bar ===
Contributors: gatemi
Tags: free shipping, progress bar, cart, woocommerce, sales
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A free-shipping progress bar that reads your store's own free-shipping rules. Activate and you're done.

== Description ==

"Add $12.50 more to unlock free shipping." Nothing nudges an order over
the line like showing shoppers how close they are — and this bar does it
with **zero configuration**, because it reads the free-shipping rules
your store already has.

* **Your store's rules are the single source of truth.** The bar finds
  the Free shipping method (with a minimum order amount) in the shipping
  zone WooCommerce itself matches for the cart — it never re-implements
  zone matching, so it can never disagree with your checkout.
* **Honest math.** The cart is measured exactly the way WooCommerce's own
  free-shipping check measures it: discounts subtracted (unless your rule
  ignores them), tax-display aware.
* **A congratulations state** the moment free shipping unlocks.
* **Shows on the cart page and shop pages**, each toggleable on one small
  settings screen (WooCommerce → Free Shipping Bar).
* **No free-shipping rule? No nag.** The bar stays hidden and the
  settings screen explains where a rule is added.
* Lightweight by design: no JavaScript, one small stylesheet, one option.

= Looking for more? =

The full edition, [Gatemi Free Shipping Bar for
WooCommerce](https://gatemi.com/plugins/free-shipping-bar-for-woocommerce/),
adds your own wording (with {remaining}, {threshold} and {total}
placeholders), brand colors with a live preview, live refresh without a
page reload, mini-cart and checkout placements, coupon-based
free-shipping rules, and a block + shortcode for manual placement.

== Frequently Asked Questions ==

= The bar does not appear — why? =

The bar appears once a shipping zone has an enabled **Free shipping**
method whose requirement is **A minimum order amount**. The settings
screen (WooCommerce → Free Shipping Bar) tells you when no such rule
exists and links to where one is added.

= My free shipping requires a coupon =

Coupon-based rules ("A valid free shipping coupon", "either", "both")
are supported by the full edition; this edition reads minimum-amount
rules.

= Does it slow my store down? =

No. It renders on the server with the page, loads one small stylesheet
and no JavaScript, and does nothing at all on pages it does not show on.

== Screenshots ==

1. The bar counting down on the cart page.
2. The congratulations state once free shipping unlocks.
3. The settings screen.

== Changelog ==

= 1.0.0 =
* Initial release: progress bar from the store's own minimum-amount
  free-shipping rule, discount- and tax-aware math, congratulations
  state, cart and shop placements with toggles.
