=== Kiswa COD Fee for WooCommerce ===
Contributors: kiswasolutions
Donate link: https://www.kiswa.net
Tags: woocommerce, cod, cash on delivery, extra fee, checkout
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a simple extra fee when customers choose Cash on Delivery (COD) in WooCommerce.

== Description ==

Many store owners need to charge a small additional amount when customers use **Cash on Delivery (COD)** because this payment method can involve extra handling costs, manual confirmation, or delivery risks.

This lightweight plugin makes it easy to apply a fee **only when COD is selected**, without affecting any other payment method. It works automatically on the cart and checkout pages and uses WooCommerce’s native settings interface.

**Key Features**

- Add a fee only when **Cash on Delivery** is selected.
- Choose between a **fixed fee** or a **percentage** of the cart subtotal.
- Optional **minimum order amount** before the fee is applied.
- Customizable fee label displayed in cart and checkout totals.
- Works with WooCommerce’s built-in COD gateway.
- Fully AJAX-compatible — fee updates instantly when the payment method changes.
- Lightweight, clean, and optimized for performance.

This plugin focuses on one simple function and does it reliably: adding a COD fee when needed.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/kiswa-cod-fee-for-woocommerce/` or install it directly from the Plugins page.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Ensure the built-in **Cash on Delivery** payment method is enabled in WooCommerce → Settings → Payments.
4. Visit **WooCommerce → Settings → COD Fee** and configure:
   - Enable or disable the fee.
   - Fee type (fixed or percentage).
   - Fee amount.
   - Minimum order total (optional).
   - Fee label.

== Frequently Asked Questions ==

= Does this work with all COD gateways? =
This plugin is designed for WooCommerce’s built-in payment method with the ID **cod**.

= Where does the fee appear? =
It shows in the **cart totals**, **checkout totals**, and on the **order summary** when Cash on Delivery is selected.

= Does the fee update automatically? =
Yes, the fee updates instantly using WooCommerce’s standard checkout refresh.

= Is the fee taxable? =
At the moment, the fee is added as non-taxable. Future versions may include a taxable option.

== Screenshots ==

1. COD Fee settings tab in WooCommerce.
2. COD fee displayed in WooCommerce checkout totals.

== Changelog ==

= 1.0.0 =
* Initial release with fixed/percentage fee support and minimum order amount option.

== Upgrade Notice ==

= 1.0.0 =
Initial stable version.