=== Product Fees Toolkit for WooCommerce ===
Contributors: riaanknoetze
Tags: woocommerce product fees, woocommerce extra fees, woocommerce surcharge, woocommerce service fee, woocommerce deposits
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html
WC requires at least: 9.0
WC tested up to: 10.4.0

Add product-level fees in WooCommerce. Fixed or percentage per product or variation, with tax, quantity and coupon support.

== Description ==

**Product Fees Toolkit for WooCommerce** lets you add clear, automatic fees directly to products and variations — without hacks, custom code, or confusing cart rules.

Perfect for **service fees, deposits, eco fees, bottle returns, gift wrapping, or compliance charges**, this plugin integrates seamlessly with WooCommerce’s pricing and tax systems so fees are applied consistently and transparently.

### Why use Product Fees Toolkit?

* Add **product-specific fees** instead of global cart fees
* Charge **fixed fees, percentage fees, or both together**
* Multiply fees by quantity for per-item charges
* Fully compatible with **WooCommerce taxes**
* Optional **Product Fees tab** on the product page for upfront pricing clarity
* Automatically **remove fees with coupons** during promotions
* Supports **simple and variable products**
* Works with **WooCommerce product Import / Export**
* Lightweight, fast, and built to feel native

No bloated settings. No checkout surprises. Just predictable fees your customers understand.

---

### Common use cases

* Environmental or recycling fees  
* Bottle or container deposits  
* Gift wrapping or handling fees  
* Age-verification or compliance charges  
* Per-item service or packaging fees  

---

### How it works (2-minute setup)

1. Edit any product in WooCommerce  
2. Open **Product Data → Product Fees**  
3. Add a fee name and amount (fixed, percent, or both)  
4. Choose whether it multiplies by quantity and applies tax  
5. Save — fees appear automatically at checkout  

---

### Where fees can be managed

* **Product level:** Products → Edit product → Product Data → Product Fees  
* **Variation level:** Products → Edit variable product → Variations → Product Fees  
* **Global options:** WooCommerce → Settings → Products → Product Fees  

Global options let you:
* Control tax behavior for fees
* Decide whether fees with the same name combine or stay separate
* Show or hide the Product Fees tab on product pages

---

### Built for store owners (and developers)

* Clean admin UI using WooCommerce standards
* No performance impact on the frontend
* Secure, nonce-protected admin saves
* Translation-ready and localization-friendly

---

== Installation ==

= Minimum Requirements =

* WordPress 6.0 or higher  
* WooCommerce 9.0 or higher  
* PHP 7.4 or higher  

= Automatic installation =

1. Go to **Plugins → Add New**
2. Search for **Product Fees Toolkit for WooCommerce**
3. Click **Install Now**, then **Activate**

= Manual installation =

1. Download the plugin ZIP
2. Go to **Plugins → Add New → Upload Plugin**
3. Upload the ZIP and activate

---

== Frequently Asked Questions ==

= Can I add fees per product instead of per cart? =
Yes. Fees are attached directly to products or variations, not globally to the cart.

= Can I charge a percentage of the product price? =
Yes. You can charge a percentage, a fixed amount, or both combined.

= Can fees multiply when customers buy more than one item? =
Yes. Enable **Multiply by Quantity** to apply the fee per item.

= Can I show fees before checkout? =
Yes. Enable the **Product Fees tab** to show fees on the product page.

= Can coupons remove fees during promotions? =
Yes. Coupons can be configured to automatically remove product fees.

= Does this work with taxes? =
Yes. Fees can be taxable, non-taxable, or inherit the product’s tax class.

= Will this work with my theme and other plugins? =
The plugin follows WooCommerce standards and works with most themes and extensions.

---

== Custom Coding & Extensibility ==

= Can developers modify fees programmatically? =
Yes. Filters are available to adjust fee labels, amounts, tax classes, and aggregation behavior before fees are added to the cart.

= Can I add fees dynamically based on product context? =
Yes. Fee data can be filtered per cart item, including quantity, price, product ID, or variation ID.

= Can I extend the admin UI? =
Yes. Action hooks allow adding custom controls t
