=== Flexible Fees Manager for WooCommerce ===
Contributors: flexiblefeesmanager
Tags: woocommerce fees, extra fees, conditional fees, cart fees, checkout fees
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add conditional fees to WooCommerce based on cart, products, shipping, payment methods, location, and more — without writing any code.

== Description ==

**Flexible Fees Manager for WooCommerce** is a comprehensive solution for adding conditional fees to your WooCommerce store based on cart contents, customer details, shipping methods, and more.

Stop losing money on small orders, special handling requests, or payment processing costs. The plugin lets you automatically add smart, conditional fees to your checkout — no coding required.

From handling charges and packaging fees to payment gateway surcharges and location-based fees, take complete control of your WooCommerce pricing strategy.

🔗 **[View Live Demo](https://demo.flexiblefeesmanager.com/)** | 🚀 **[Upgrade to Pro](https://flexiblefeesmanager.com/)**

== ✨ What Makes Flexible Fees Manager Different? ==

* **Visual Condition Builder** – No coding. Just point, click, and configure
* **20+ Condition Types** – Comprehensive fee conditions for various use cases
* **Smart Logic** – Combine conditions with AND/OR for complex rules
* **Real-time Preview** – See exactly what customers will pay
* **Performance Optimized** – Lightweight and efficient
* **Developer Friendly** – Hooks and filters for customization

== 🎯 Built For Every WooCommerce Store ==

### 🛒 General Store Owners
Automatically add handling fees for small orders, packaging charges, or service fees. Protect your margins without manually adjusting prices.

### 🌍 International Sellers
Apply country-specific fees, regional surcharges, or customs handling charges. Support 200+ countries with granular control over fees by state, city, or zipcode.

### 💼 B2B & Wholesale
Different fees for different customer types. Charge handling fees to retail customers while offering fee-free orders to your wholesale partners.

### 📦 Shipping-Intensive Businesses
Weight-based fees, oversized item charges, or special handling for fragile products. Your shipping costs, your rules.

### 💳 Payment Processing
Pass payment gateway fees to customers who choose specific payment methods. COD fees, credit card processing charges, PayPal fees — all automated.

== 🆓 FREE VERSION FEATURES ==

### Core Fee Conditions

| Condition | Description |
|-----------|-------------|
| **Cart Subtotal** | Apply fees based on cart value (e.g., $5 fee if order < $50) |
| **Subtotal ex. taxes** | Same as above, excluding tax amounts |
| **Contains Product** | Fees when specific products are in cart |
| **Country** | Location-based fees by customer country |
| **User Role** | Different fees for customers, subscribers, wholesale, etc. |
| **Product Length** | Dimensional shipping fees |
| **Stock Quantity** | Fees based on available stock |
| **Stock Status** | Fees for in-stock or backorder items |

### Fee Calculation Types

* **Fixed Amount** – Flat fee (e.g., $5.00 handling)
* **Percentage** – Percentage of cart total (e.g., 3% service fee)
* **Per Quantity** – Fee per item in cart (e.g., $0.50 per item)

### Core Features

✅ **Visual Condition Builder** – Create complex rules with an intuitive UI
✅ **AND/OR Logic Groups** – Combine conditions for precise targeting
✅ **Discounts Support** – Negative fees = automatic discounts
✅ **Tax Configuration** – Apply tax classes to fees
✅ **Status Management** – Enable/disable fees instantly
✅ **Duplicate Fees** – Clone existing fees with one click
✅ **Bulk Actions** – Activate/deactivate multiple fees at once
✅ **Schedule Fees** – Set fees to publish at a future date
✅ **Modern UI** – Clean, intuitive admin interface

== ⭐ PRO VERSION FEATURES ==

Unlock the full potential with [Flexible Fees Manager Pro](https://flexiblefeesmanager.com/):

### 🔥 Advanced Fee Conditions

| Condition | Description | Use Case |
|-----------|-------------|----------|
| **Payment Method** | Fees per payment gateway | 3% credit card fee, $2 COD charge |
| **Shipping Method** | Fees per shipping option | $5 express shipping surcharge |
| **Cart Quantity** | Total items in cart | Bulk order handling fee |
| **Cart Weight** | Total cart weight | Heavy item surcharge |
| **Product Category** | Category-based fees | Fragile item handling |
| **Shipping Class** | Shipping class fees | Oversized item charge |
| **Coupon Applied** | Fees when coupons used | Processing fee on discounted orders |
| **Tax Amount** | Cart tax total | Tax-based surcharges |
| **Zipcode** | Postal code targeting | Remote area delivery fee |
| **City** | City-specific fees | Urban delivery surcharge |
| **State/Province** | Regional fees | State-specific handling |
| **Product Width** | Width-based fees | Wide item handling |
| **Product Height** | Height-based fees | Tall item handling |

### 📊 Analytics Dashboard

Make data-driven decisions with comprehensive fee analytics:

* **Total Fee Revenue** – Track extra revenue from fees
* **Orders with Fees** – See how many orders include fees
* **Average Fee per Order** – Understand fee impact
* **Revenue Trend Charts** – Visualize performance over time
* **Top Performing Fees** – Identify your most valuable fees
* **Revenue by Fee Breakdown** – See which fees earn the most
* **Orders Over Time** – Track fee application trends
* **Custom Date Ranges** – Filter by any period

### 🎯 Advanced Conditions (Tiered Pricing)

Create sophisticated tiered fee rules with **Advanced Conditions**:

* **Product-specific rules** – Different fees for different products
* **Quantity tiers** – Fee changes based on quantity ranges
* **Multiple rules per condition** – Stack rules for complex pricing
* **Min/Max quantity support** – Precise quantity-based control

**Example:** 
- 1-10 items: $2 per item
- 11-50 items: $1.50 per item  
- 51+ items: $1 per item

### 🛟 Priority Support

* Dedicated email support
* Faster response times
* Help with complex configurations
* Feature request consideration

🔗 **[Get Flexible Fees Manager Pro](https://flexiblefeesmanager.com/)**

== 📋 REAL-WORLD USE CASES ==

### 💰 Small Order Fee
**Problem:** Small orders eat into your margins with fixed shipping and handling costs.
**Solution:** Add a $5 handling fee for orders under $50.

`
Condition: Cart Subtotal < $50
Fee: $5.00 Fixed
`

### 💳 Payment Gateway Fee (Pro)
**Problem:** Credit card processing costs 2.9% + $0.30 per transaction.
**Solution:** Pass the fee to customers who choose credit cards.

`
Condition: Payment Method = Stripe
Fee: 2.9% + $0.30
`

### 🚚 Cash on Delivery Fee (Pro)
**Problem:** COD orders require extra handling and carry higher risk.
**Solution:** Add a $3 COD processing fee.

`
Condition: Payment Method = Cash on Delivery
Fee: $3.00 Fixed
`

### 🌍 International Shipping Surcharge
**Problem:** International orders have higher shipping and customs costs.
**Solution:** Add $15 for orders outside your home country.

`
Condition: Country ≠ United States
Fee: $15.00 Fixed
`

### ⚖️ Heavy Item Fee (Pro)
**Problem:** Heavy products cost more to ship and handle.
**Solution:** Add $10 for carts weighing over 20kg.

`
Condition: Cart Weight > 20kg
Fee: $10.00 Fixed
`

### 📦 Oversized Item Handling (Pro)
**Problem:** Large items require special packaging and handling.
**Solution:** Add fees based on product dimensions.

`
Condition: Product Width > 100cm OR Product Height > 100cm
Fee: $25.00 Fixed
`

### 🏷️ Category Handling Fee (Pro)
**Problem:** Fragile electronics need special packaging.
**Solution:** Add handling fee for specific categories.

`
Condition: Category = Electronics
Fee: $8.00 Fixed
`

### 👥 Wholesale Discount
**Problem:** Want to incentivize wholesale customers.
**Solution:** Remove handling fees for wholesale role.

`
Condition: User Role = Wholesale
Fee: -$5.00 (Discount)
`

### 🎁 Express Shipping Premium (Pro)
**Problem:** Express shipping costs you more.
**Solution:** Add surcharge for express options.

`
Condition: Shipping Method = Express
Fee: $10.00 Fixed
`

### 🏙️ Remote Area Surcharge (Pro)
**Problem:** Delivering to remote areas costs more.
**Solution:** Add fees for specific zipcodes.

`
Condition: Zipcode IN (remote area codes)
Fee: $20.00 Fixed
`

== 🔧 HOW IT WORKS ==

**Step 1: Create a Fee**
Navigate to Flexible Fees Manager → Add New Fee

**Step 2: Configure Fee Settings**
- Enter a descriptive fee title (shown at checkout)
- Set the fee amount and calculation type
- Configure tax settings if applicable

**Step 3: Set Your Conditions**
- Choose condition type (subtotal, country, payment method, etc.)
- Select operator (equals, not equals, greater than, less than)
- Enter the condition value

**Step 4: Add Multiple Conditions (Optional)**
- Click "Add New Condition" for AND logic
- Click "Create OR Group" for OR logic
- Build complex rules with multiple condition groups

**Step 5: Publish**
- Save your fee
- It automatically applies at checkout when conditions match

== Installation ==

= Automatic Installation (Recommended) =

1. Log in to your WordPress admin panel
2. Go to **Plugins → Add New**
3. Search for "**Flexible Fees Manager for WooCommerce**"
4. Click **Install Now**, then **Activate**
5. Go to **Flexible Fees Manager** to create your first fee

= Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins → Add New → Upload Plugin**
3. Choose the ZIP file and click **Install Now**
4. Activate the plugin
5. Go to **Flexible Fees Manager** to get started

= Requirements =

* WordPress 5.0 or higher
* WooCommerce 7.0 or higher
* PHP 7.4 or higher

== Frequently Asked Questions ==

= How quickly can I set up my first fee? =

In under 2 minutes! Simply go to Flexible Fees Manager → Add New, enter a title and amount, add your condition, and publish. The fee will immediately apply at checkout.

= Will fees show to customers before checkout? =

Yes! Fees appear in the cart page as well as the checkout page, so customers always know exactly what they'll pay.

= Can I create discounts, not just fees? =

Absolutely! Enter a negative amount (e.g., -$5 or -10%) to create conditional discounts.

= Does it work with WooCommerce Blocks checkout? =

Yes, Flexible Fees Manager is fully compatible with both the classic WooCommerce shortcode checkout and the new WooCommerce Blocks checkout.

= Can I combine multiple conditions? =

Yes! Use AND logic (all conditions must match) or OR logic (any condition can match) to create sophisticated rules. You can even combine AND and OR in the same fee.

= What payment methods can I apply fees to? (Pro) =

Any payment gateway enabled in your WooCommerce store — Stripe, PayPal, Cash on Delivery, Bank Transfer, Square, and all others.

= Can I schedule fees to activate later? =

Yes! Set any fee to "Scheduled" status and pick a future date/time. The fee will automatically activate when that time arrives.

= Will this slow down my checkout? =

Not at all. The plugin is optimized for performance and only runs during cart/checkout calculations. We've tested with stores processing thousands of orders daily.

= Can I apply different fees to different customer types? =

Yes! Use the "User Role" condition to create fees for specific roles like Customer, Subscriber, Wholesale, Shop Manager, or any custom roles.

= How do I apply a fee only when a coupon is used? (Pro) =

Use the "Coupon" condition to apply fees when specific coupons are applied to the cart.


= What happens if I deactivate the plugin? =

All fee configurations are safely preserved in your database. Simply reactivate to restore them.

= Do you offer refunds? =

Yes! Pro licenses come with a 14-day money-back guarantee. If you're not satisfied, contact us for a full refund.

= How do I get support? =

- **Free users:** Use the WordPress.org support forum
- **Pro users:** Contact us through [flexiblefeesmanager.com/support](https://flexiblefeesmanager.com/help-support/) for priority support

= How can I report a bug or security issue? =

For bugs, please use the support forum or contact us directly. For security vulnerabilities, please email us privately at hello@flexiblefeesmanager.com.

== Screenshots ==

1. **All Fees Dashboard**  
   View and manage all fee rules from one place. Easily activate, deactivate, edit, or duplicate fees with a single click.

2. **Analytics Dashboard**  
   Track fee revenue, orders with applied fees, and performance trends using clear visual charts.

3. **Visual Condition Builder**  
   Create fee rules using an intuitive condition builder with 20+ condition types and simple grouping options.

4. **Fee Settings Panel**  
   Configure the fee title, calculation type (fixed, percentage, or per quantity), fee amount, and tax settings.

5. **AND / OR Logic Groups**  
   Build advanced fee rules by combining multiple conditions using AND / OR logic for precise control.

== Changelog ==

= 1.0.1 - 2025-12-25 =
* Small fix

= 1.0.0 - 2025-12-24 =
* 🎉 Initial Release
* ✨ Fee conditions: Subtotal, Subtotal ex. taxes, Contains Product, Country, User Role, Length, Stock, Stock Status
* ✨ Fee calculation types: Fixed Amount, Percentage, Per Quantity (multiply by cart quantity)
* ✨ Support for fee discounts with negative amounts
* ✨ AND/OR condition logic with multiple groups
* ✨ Tax class configuration for fees
* ✨ Enable/disable toggle for quick fee management
* ✨ Duplicate, Trash, and Restore functionality
* ✨ Bulk actions: Activate, Deactivate, Delete
* ✨ Schedule fees for future activation
* ✨ Modern, intuitive admin interface
* ✨ Full WooCommerce Blocks compatibility

== Upgrade Notice ==

= 1.0.0 =
Welcome to Flexible Fees Manager for WooCommerce! Create conditional fees for your store in minutes. Visit Flexible Fees Manager in your admin to get started.


== Additional Resources ==

* 🎮 **[Live Demo](https://demo.flexiblefeesmanager.com/)** – Try before you buy
* ⭐ **[Get Pro](https://flexiblefeesmanager.com/)** – Unlock all 20+ conditions and analytics
* 💬 **[Support](https://flexiblefeesmanager.com/help-support/)** – Get help from our team

== Love Flexible Fees Manager? ==

* 🌟 **[Leave a 5-star review](https://wordpress.org/support/plugin/flexible-fees-manager-for-woocommerce/reviews/#new-post)** – Your review helps others discover us!
* 📣 **Share with friends** – Know someone who could use this? Tell them about it!
* 💼 **[Upgrade to Pro](https://flexiblefeesmanager.com/)** – Support development and unlock all features
