=== SPP Free Shipping Threshold for WooCommerce ===
Contributors: simpliplugin
Tags: woocommerce, free shipping, shipping threshold, cart, checkout
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display realtime free-shipping progress on cart and checkout to encourage higher order values.

== Description ==

**SPP Free Shipping Threshold for WooCommerce** helps increase average order value (AOV) by showing customers exactly how much more they need to spend to unlock free shipping.

The plugin reads the cart subtotal from the WooCommerce session, compares it against your configured threshold, and renders a responsive progress bar with a clear outstanding-balance message.

= Features =

* Realtime threshold tracking using `WC()->cart->get_subtotal()`
* Renders on cart, checkout, and mini cart
* Configurable threshold amount and custom messages
* Visual progress bar with current subtotal vs. goal
* AJAX cart fragment updates when items are added or removed
* WooCommerce HPOS compatible
* Lightweight, no external dependencies

= Placeholders =

Use these tags in the in-progress message:

* `{remaining}` — amount still needed for free shipping
* `{threshold}` — free shipping goal amount
* `{subtotal}` — current cart subtotal
* `{progress}` — percentage toward the goal

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install through the WordPress plugins screen.
2. Activate the plugin through the **Plugins** screen.
3. Go to **WooCommerce → Free Shipping Threshold** to set your threshold amount and messages.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and active.

= Where does the bar appear? =

By default on the cart page (via `woocommerce_before_cart`), checkout page, and mini cart widget. You can toggle each location in settings.

= Does tax count toward the threshold? =

The plugin uses the cart subtotal (`get_subtotal()`), which excludes tax and shipping by default.

== Screenshots ==

1. Free shipping progress bar on the cart page.
2. Plugin settings under WooCommerce.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
