=== Really Simple Free Shipping: Selected Products, Progress Bars and Counters for WooCommerce ===
Contributors: jetixwp, lushkant
Requires at least: 6.0
Requires PHP: 8.0
Tested up to: 6.9
Stable tag: 1.1.0
WC requires at least: 7.0
WC tested up to: 10.4.3
Tags: shipping, woocommerce, free shipping, woocommerce shipping, product
License: GPLv2
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Extends default free shipping workflow of WooCommerce to conditionally apply free shipping on Selected Products and more.

== Description ==

**Really Simple Free Shipping for WooCommerce** is a powerful plugin that extends WooCommerce's default free shipping functionality. It allows you to:

- ✅ **Selected Products Free Shipping** - Enable free shipping for specific products or product selections
- ✅ **Progress Indicators** - Display visual progress bars and text to customers showing how close they are to qualifying for free shipping
- ✅ **Flexible Calculations** - Use multiple calculation methods for cart totals (subtotal, total, contents, with/without discounts and taxes)
- ✅ **Free Shipping with or Without Minimum Cart Value** - Apply free shipping with or without minimum cart value requirements
- ✅ **Performance Optimized** - Caching and optimized database queries
- ✅ **Shipping Counters** - Real-time progress updates as cart changes
- ✅ **Easy to Use** - Simple admin interface with clear configuration options

#### System Requirements

- WordPress 6.0 or higher
- PHP 8.0 or higher
- WooCommerce 7.0 or higher

### Basic Configuration

### Step 1: Select Products for Free Shipping

1. Go to **JetixWP > Free Shipping**
2. You'll be on the **Selected Products** tab
3. Under the "Products" field, select the products that should qualify for free shipping
	 - You can search for products by name
	 - Multiple products can be selected
	 - Use Ctrl/Cmd + Click to select/deselect individual products

4. Choose a method:
	 - **Selected Products with Minimum Cart Value**: Requires BOTH a selected product in cart AND minimum cart value met
	 - **Selected Products without Minimum Cart Value**: Requires ONLY a selected product in cart

5. Click **Save Changes**

### Step 2: Create a Shipping Zone (if needed)

1. Go to **WooCommerce > Settings > Shipping > Shipping zones**
2. Click **Add Shipping Zone** or edit an existing zone
3. Configure the zone (region/country)
4. Under "Shipping Methods", click **Add Shipping Method**
5. Select **"Free Shipping - Selected Products"** from the dropdown
6. Enter a **Method Title** (e.g., "Free Shipping - Selected Items")
7. Optionally set a minimum order amount
8. Save the zone

### Step 3: Enable Progress Display (Optional)

To show customers a progress bar or progress text indicating how close they are to free shipping:

#### Progress Bar

1. Go to **JetixWP > Free Shipping**
2. Click the **Progress Bar** tab
3. Check **Enable Progress Bar**
4. Optionally check **Show Globally** to display on all pages (recommended)
5. Customize colors and messages as desired
6. Click **Save Changes**
7. Add the shortcode `[rs_free_shipping_progress_bar]` to your shop page, cart page, or sidebar

#### Progress Text

1. Go to **JetixWP > Free Shipping**
2. Click the **Progress Text** tab
3. Check **Enable Progress Text**
4. Customize the messages using available placeholders:
	 - `{goal_counter}` - Amount needed to reach free shipping
	 - `{goal_total}` - Total required for free shipping
	 - `{current_cart_total}` - Current cart total
5. Click **Save Changes**
6. Add the shortcode `[rs_free_shipping_progress_text]` to your site

== Installation ==

This section describes how to install the plugin and get it working. e.g.

1. Upload the plugin files to the `/wp-content/plugins/really-simple-free-shipping` directory, or install the plugin through the Plugins >> Add new screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Head to 'JetixWP >> Free Shipping' page from WordPress sidebar menu.

== Frequently Asked Questions ==

= Where can I get help? =
You can get help by submitting your issue in the plugin forums.

== Screenshots ==

1. Product page with Selected Products in Cart
2. Progress Bars and Counters
3. Settings page view
4. Design controls at Settings

== Changelog ==

= 1.1.0 =
* Add Freemius SDK
* Prepare for WP.org live
* Other minor changes

= 1.0.2 =
* Fix unsanitized array keys used in $_POST access

= 1.0.1 =
* Fix wp.org review issues

= 0.1.0 =
* Initial release