=== LW RunningCart Progress Bar for WooCommerce ===
Contributors: lindalove70
Tags: woocommerce, free shipping, cart, checkout, progress bar
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display a WooCommerce free shipping progress indicator in the cart, checkout, and mini cart.

== Description ==

LW RunningCart Progress Bar for WooCommerce helps shoppers see how close their cart is to a free shipping goal. The plugin displays a lightweight progress indicator in WooCommerce cart, Classic Checkout, and common mini cart layouts.

Store owners can set the free shipping threshold, choose display locations, adjust colors, and edit the messages shown before and after the threshold is reached.

Features:

* Cart progress indicator.
* Classic Checkout progress indicator.
* Mini cart, side cart, and drawer cart support for common WooCommerce layouts.
* Configurable free shipping threshold.
* Separate colors for before and after the threshold is reached.
* Configurable text size and message templates.
* Live refresh support for WooCommerce cart and checkout updates.
* Optional hiding of WooCommerce `flat_rate` shipping methods after the configured threshold is reached.
* HPOS compatible.

Supported message variables:

* `{amount}`: remaining amount before free shipping.
* `{threshold}`: configured free shipping threshold.
* `{subtotal}`: current cart subtotal.

The plugin does not process payments, create shipping labels, connect to third-party services, or send data to external services.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/lw-runningcart-progress-bar/` directory, or install the plugin through the WordPress Plugins screen.
2. Activate the plugin through the Plugins screen in WordPress.
3. Make sure WooCommerce is installed and active.
4. Open the LW RunningCart Progress Bar for WooCommerce settings page.
5. Set the free shipping threshold and choose where the indicator should appear.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and active.

= Does this plugin support HPOS? =

Yes. The plugin declares WooCommerce HPOS compatibility.

= Does this plugin change WooCommerce payment flow? =

No. It does not change payment processing, payment success pages, or payment failure handling.

= Does this plugin hide shipping methods? =

When the configured free shipping threshold is reached, the plugin hides WooCommerce `flat_rate` shipping methods. Free shipping and non-flat-rate methods remain available.

= Does this plugin call external services? =

No. The plugin does not call external services and does not send store or customer data to third-party systems.

== Screenshots ==

1. Settings page with the threshold, display locations, style controls, and live preview.
2. Cart progress indicator before the free shipping threshold is reached.
3. Progress indicator after the free shipping threshold is reached.

== Changelog ==

= 1.0.4 =
* Confirms the public plugin name as LW RunningCart Progress Bar for WooCommerce.
* Keeps the Traditional Chinese plugin name and admin menu label as 跑跑免運車.
* Preserves WooCommerce cart, checkout, mini cart, AJAX refresh, HPOS compatibility, and flat-rate hiding after the configured threshold is reached.

= 1.0.3 =
* Cleans up legacy side-cart progress fragments from older package markup before rendering the new namespaced RunningCart bar.
* Prevents stale mini-cart truck images from appearing as oversized images after updating from the previous namespace.
* Preserves WooCommerce cart, checkout, mini cart, AJAX refresh, HPOS compatibility, and flat-rate hiding after the configured threshold is reached.

= 1.0.2 =
* Isolated PHP constants, class names, settings, AJAX action, JavaScript globals, and CSS selectors from the older `lovewoo-freeshipping-bar` plugin.
* Added a coexistence guard that pauses RunningCart and shows an admin notice when the older self-use plugin is still active.
* Preserved WooCommerce cart, checkout, mini cart, AJAX refresh, HPOS compatibility, and flat-rate hiding after the configured threshold is reached.

= 1.0.1 =
* Renamed the WordPress.org package to LW RunningCart Progress Bar for WooCommerce.
* Added a Settings shortcut in the WordPress plugins list.
* Preserved WooCommerce cart, checkout, mini cart, AJAX refresh, HPOS compatibility, and flat-rate hiding after the configured threshold is reached.

= 1.0.0 =
* Initial release with cart, checkout, mini cart, AJAX refresh, configurable messages, color settings, and flat-rate hiding after the free shipping threshold is reached.

== Upgrade Notice ==

= 1.0.4 =
Name alignment update after beta verification. Runtime behavior is unchanged.

= 1.0.3 =
Fixes stale side-cart fragment cleanup after the RunningCart namespace isolation update.

= 1.0.2 =
Namespace isolation update for safer coexistence with older LoveWoo self-use installs. Existing settings are read first from `lw_rcpb_settings`, with old settings used only as a read-only fallback.

= 1.0.1 =
Public package identity update with a plugins-list Settings shortcut. Existing settings remain compatible.
