=== City & Zip Based Shipping Rate for WooCommerce ===
Contributors: codiepress, reponwp
Tags: shipping rate, city-based shipping, zip code shipping, postcode shipping, local delivery
Requires at least: 6.2
Tested up to: 7.1
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Flexible WooCommerce shipping by City or ZIP/Postcode — charge fixed, weight-based, quantity or subtotal delivery fees for accurate pricing.

== Description ==

**City & Zip Based Shipping Rate for WooCommerce** makes location-based delivery pricing simple. If your shipping cost depends on where your customers live, this plugin gives you the tools to charge correctly and stay profitable.

Add a shipping rate line item and assign **multiple cities** and **multiple ZIP/Postcodes** under that rate. Then choose how you want shipping cost to be calculated:

✔ Fixed price  
✔ Based on total cart weight  
✔ Based on quantity of items in the cart  
✔ Based on cart subtotal value  

This flexibility allows online stores to apply accurate delivery charges depending on the area and order size. You can **exclude virtual products** from cost calculations to ensure only shippable items are considered.

The free version allows up to **10 cities and 10 ZIP/Postcodes per rate item** — perfect for small delivery zones. Need more? Upgrade to Pro for unlimited locations and large coverage areas.

If a customer enters a location outside your service area, you can:

❌ Hide shipping methods completely  
✅ OR apply a custom fallback shipping cost  

This ensures customers only see the delivery options that match your business capability.


### ✅ Why This Plugin Helps Your Business

Because shipping costs are not the same everywhere!

Different areas require different delivery pricing strategies:

- Some cities may be closer → lower shipping fee  
- Remote ZIP codes may require higher charges  
- Expensive courier zones may need extra handling fees  
- Certain ZIP/Postcodes may not be serviceable at all  

With this plugin, **you control where and how much you deliver** — no guessing and no profit loss.

Ideal for:

🏪 Local retail shops  
🍔 Food & grocery delivery  
📦 Courier and parcel delivery  
🏗️ Hardware & building supply stores  
🛋️ Furniture, appliances & heavy products  
🏥 Pharmacy, florist & urgent delivery businesses  
🎯 City-restricted or postcode-limited shipping zones  


### ✅ Key Features

- Create delivery rate items based on City or ZIP/Postcode  
- Add multiple location values per shipping cost item  
- Charge a flat delivery fee or a dynamic one  
- Define pricing using weight, quantity, or subtotal  
- Exclude virtual products from calculation  
- Hide shipping if location does not match  
- Choose default fallback cost for unmatched areas  
- Works with all shipping zones  
- Fast setup — no coding required  
- Lightweight and optimized for performance  

### 🚀 Upgrade to Pro for More Power

✅ Unlimited cities per rate item  
✅ Unlimited ZIP/Postcodes per rate item  
✅ Dedicated priority support  
✅ Frequent feature enhancements  

Designed for growing businesses with large delivery coverage.

== Installation ==

1. Upload the `city-zip-based-shipping-rate-for-woocommerce` folder to the `/wp-content/plugins/` directory  
2. Activate the plugin through the **Plugins** menu in WordPress  
3. Go to **WooCommerce → Settings → Shipping**  
4. Add or edit a shipping zone  
5. Select **City & ZIP Based Shipping Rate** and start adding line-item rates  


## 🙌 About

If you enjoy this plugin, please leave us a 5-star review and help it grow! ⭐⭐⭐⭐⭐

== Frequently Asked Questions ==

= Can I use both City and Postcode together?
Yes. You can enter either or both.

= Can different cities have different prices?
Yes. Each rate item supports its own pricing.

= What happens if the customer’s City or ZIP does not match?
You can hide the shipping method entirely or show a fallback cost.

= Does it support weight-based shipping?
Yes — plus quantity-based and subtotal-based shipping.

= Is there a Pro version?
Yes! Pro removes all location limits and includes advanced flexibility for large coverage stores.

== Changelog ==

= 1.0.1 =
* WordPress 7.1 Compatibility Check

= 1.0.0 =
* Inital release