=== Yalhem Shipping for WooCommerce ===
Contributors: tonyhelmy
Tags: shipping, courier, cash on delivery, saudi arabia, egypt
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Send your WooCommerce orders to your courier on Yalhem Shipping System: shipments, labels, live delivery status and shipping prices at checkout.

== Description ==

For stores whose courier (delivery company) runs on Yalhem Shipping System (سيستم شحن يلهم), in Saudi Arabia and Egypt.

* **Shipments from orders:** automatically when an order reaches a status you choose (Processing by default), or with a button / bulk action.
* **Cash on delivery:** orders paid with your COD methods go out with the order total for the driver to collect.
* **Labels:** print the courier's label from the order screen or the orders list.
* **Live status:** out for delivery, delivered, failed attempt… appear as order notes; delivered orders can be completed automatically.
* **Tracking for customers:** a tracking link in the order page and emails.
* **Shipping price at checkout:** a shipping method that shows the courier's price for the customer's city and the cart weight.
* City names are matched for you: "Riyadh", "al-Khobar", "Nasr City" and Arabic spellings all work. For cities split into districts (like Riyadh), the district is found in the address.

Works with HPOS (custom order tables) and the block checkout.

== Installation ==

1. Install and activate the plugin.
2. Ask your courier for an API key for your store (they create it in Settings → Integrations (API)).
3. WooCommerce → Settings → Shipping → Yalhem Shipping: paste the key and save. You'll see "Connected to …".
4. Optional: add the "Yalhem Shipping (live price)" method to a shipping zone.

Your site must be reachable over HTTPS for delivery updates to arrive.

== Screenshots ==

1. Settings: paste the key from your courier and you're connected. Choose when shipments are created and which payment methods are cash on delivery.
2. The order screen: the shipment number, its delivery status and buttons to print the label, track it or refresh the status.
3. The orders list: every order shows its shipment and status.

== External services ==

This plugin sends order shipping data (customer name, phone, address, city, items, order total for cash on delivery) to the Yalhem Shipping System API of your courier
(default https://shipping.yalhem.com) when a shipment is created or a shipping price is requested, and receives delivery updates from it.
Terms: https://yalhem.com/terms/ · Privacy: https://yalhem.com/privacy-policy/

== Changelog ==

= 0.1.0 =
* First version.
