=== Arab Commerce Manager ===
Contributors: roeia
Tags: woocommerce, cash on delivery, shipping, arabic, egypt
Requires at least: 6.4
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

The complete, free Cash-on-Delivery toolkit for Arab WooCommerce stores — addresses, shipping, COD, risk, order confirmation, carriers, reports and more.

== Description ==

Arab Commerce Manager makes WooCommerce work the way stores in the Arab region actually operate. Everything below is included and free:

**Addresses & checkout**
* Arabic-first checkout: governorates/regions/emirates and city dropdowns for Egypt, Saudi Arabia and the UAE, plus district, building number and landmark fields. Full RTL, Arabic/English, HPOS and Checkout Blocks.

**Shipping**
* Region & city shipping rates inside WooCommerce Shipping Zones, free-shipping threshold, delivery estimates, blocked areas, CSV import/export.
* Advanced rule engine — composite AND/OR rules on region, city, weight, cart total, products, payment, day; add/percent/set/free/block actions.
* Multi-branch / warehouses with automatic order routing by service region.

**Cash on Delivery**
* COD controls by region, min/max totals, COD fee.
* COD deposit (prepayment) — collect part upfront; the carrier collects only the remainder.

**Anti-fraud & confirmation**
* Manual blacklist (phone/email/IP), rate limiting, customer-history notes.
* Order risk scoring with configurable factors and optional auto-reject.
* Order confirmation by secure link over Email, WhatsApp or SMS, with auto-cancel on expiry.

**Fulfilment & integrations**
* Carrier connectors (Bosta, Aramex) — create shipments, tracking and labels — plus WhatsApp and SMS messaging connectors; you bring your own API keys.
* Carrier CSV export templates.
* REST API and signed Webhooks.

**Operations**
* RTO / returns & losses reports, orders CSV export, printable packing list, activity log, and staff roles.
* Agency White Label.

== Installation ==

1. Install and activate WooCommerce 8.9 or newer.
2. Install and activate Arab Commerce Manager.
3. Add the "Arab Commerce Shipping" method to your shipping zones under WooCommerce → Settings → Shipping.
4. Configure everything under the "Arab Commerce" admin menu.

== Frequently Asked Questions ==

= Does it work with my theme? =

Yes. The plugin only extends WooCommerce's own checkout fields and admin screens; it does not change your theme.

= Which countries are included? =

Egypt, Saudi Arabia and the United Arab Emirates ship with full governorate/region and city data. More countries are planned, and you can add custom cities for any supported country.

== Changelog ==

= 0.1.0 =
* Initial release.
