=== MidoForm Order Form for WooCommerce ===
Contributors: riadhdev
Tags: woocommerce, cod, cash on delivery, order form, checkout
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight Cash on Delivery order form for WooCommerce, built for the Algerian market.

== Description ==

MidoForm replaces the standard WooCommerce checkout with a simple, focused order form designed for Cash on Delivery (COD) stores. Place the form on any page or post using a shortcode — customers fill in their name, phone number, wilaya, and baladia, and the order is created instantly in WooCommerce.

Built specifically for Algerian e-commerce stores, the form includes all 58 wilayas and their baladias out of the box, with no configuration needed.

**How it works:**

1. Add the shortcode `[midoform id="PRODUCT_ID"]` to any page
2. The form loads with the product details and a quantity selector
3. The customer fills in their delivery information and submits
4. A WooCommerce order is created automatically and set to Processing
5. The customer is redirected to the WooCommerce order confirmation page

**Features:**

* Simple, mobile-friendly RTL form
* All 58 Algerian wilayas with baladia dropdowns
* Supports simple and variable WooCommerce products
* Live order summary with quantity control
* Built-in rate limiting to prevent duplicate orders
* Nonce-based security on every submission
* Lightweight — assets only load on pages that use the shortcode
* No settings page needed

**Requirements:**

* WordPress 5.8 or higher
* WooCommerce (must be installed and active)
* PHP 7.4 or higher
* Cash on Delivery payment method enabled in WooCommerce

== Installation ==

1. Upload the `midoform` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Make sure WooCommerce is installed and active.
4. Enable the **Cash on Delivery** payment method in WooCommerce → Settings → Payments.
5. Edit any page or post and add the shortcode: `[midoform id="123"]` — replace `123` with your WooCommerce product ID.

== Frequently Asked Questions ==

= Where do I find my product ID? =

Go to WooCommerce → Products, hover over the product, and the ID is shown below the product name. You can also find it in the URL when editing the product.

= Does it work with variable products? =

Yes. If the product has variations (size, color, etc.), the form will automatically show dropdown selectors for each attribute.

= Can I use it for multiple products? =

Yes. Place the shortcode on different pages with different product IDs. Each page will show the form for that specific product.

= Does the plugin work outside Algeria? =

Currently the plugin is built for the Algerian market — the location fields (wilaya/baladia) and phone number validation are specific to Algeria. Support for additional countries is planned for a future release.

= What happens after the customer submits the form? =

A WooCommerce order is created and set to "Processing" status with Cash on Delivery as the payment method. The customer is redirected to the standard WooCommerce order confirmation page.

= Is there a settings page? =

No. The plugin works out of the box with no configuration required.

== Changelog ==

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release.
