=== Aramex eCommCore ===
Contributors: aramex
Tags: woocommerce, shipping, aramex, tracking, inventory
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Seamlessly connect WooCommerce with Aramex Unified Portal for automated orders, shipment creation, tracking, and inventory sync.

== Description ==

**eCommCore** seamlessly integrates WooCommerce with **Aramex Unified Portal**, enabling automatic order transmission, shipment creation, live tracking updates, and near real-time stock sync.

This plugin is designed for merchants who use **Aramex Unified Portal (WMS + Last-mile)** for eCommerce fulfillment and shipping.

= Key Features =

* Automatic order submission to Aramex Unified Portal
* Shipment creation directly from WooCommerce
* Real-time shipment status and tracking updates
* Near real-time stock synchronization
* Support for COD & prepaid orders
* Tracking link visible in WooCommerce order details
* Secure token-based API communication

= Use Cases =

* Stores shipping with Aramex Unified Portal
* Businesses needing real-time warehouse stock sync
* Stores requiring automated shipping label + tracking updates
* Hybrid fulfillment via Aramex + in-house inventory

= Requirements =

* WordPress 5.8 or higher
* WooCommerce 5.0 or higher
* PHP 7.4 or higher
* Active Aramex Unified Portal account (WMS Access)

== External Services ==

This plugin connects to Aramex Unified Portal & Tracking services.

1. **Aramex Unified Portal API**
   - Purpose: Order submission, shipment creation, status updates, stock sync
   - Data Sent: Order details, shipping address, AWB number, inventory info
   - Terms: https://www.aramex.com/sa/en/terms-and-conditions
   - Privacy Policy: https://www.aramex.com/sa/en/legal-details/privacy-policy

2. **Aramex Shipment Tracking**
   - Purpose: Order tracking page
   - Data Sent: AWB number only

All communication is secure and encrypted. Only shipping-related data necessary for fulfillment is shared.

== Installation ==

1. Upload plugin files to `/wp-content/plugins/aramex-ecommcore`
2. Activate plugin via **WordPress Admin → Plugins**
3. Navigate to **eCommCore** and Activate
4. Click on Admin Menu Called eCommCore
5. Click Continue and Fulfill all details to connect your store

== Frequently Asked Questions ==

= Do I need an Aramex account? =
Yes, an active Aramex Unified Portal account is required.

= Does this support COD shipping? =
Yes — COD & prepaid both supported.

= Is manual sync available? =
Not Directly — but you can trigger manual sync from the ecommcore dashboard.

= Does it support variable products? =
Yes — full support for simple & variable products.

= Is customer data secure? =
Yes — secure token-based communication & sanitized requests.

== Screenshots ==

1. Login Page
2. eCommCore Dashboard
3. Plugin Settings Page
4. Tracking & Logs View

== Changelog ==

= 1.0.6 =
* Fixed COD and Custom value for multi quantity items.

= 1.0.5 =
* Added Preferred Currency Code for MultiRates Shipping API.

= 1.0.4 =
* Added Billing Address fallback if Shipping Address is empty.
* Cleaned the multilingual blog name.

= 1.0.3 =
* Added Title key for UpdateSO API.

= 1.0.2 =
* Added Signatured based API authentication.

= 1.0.1 =
* Added HSCODE and Unit Price in Shipment.

= 1.0.0 =
* Initial stable release for eCommCore
* Order sync, shipment create, tracking, stock sync

== Upgrade Notice ==

= 1.0.6 =
* Fixed COD and Custom value for multi quantity items.

= 1.0.5 =
* Added Preferred Currency Code for MultiRates Shipping API.

= 1.0.4 =
* Added Billing Address fallback if Shipping Address is empty.
* Cleaned the multilingual blog name.

= 1.0.3 =
* Added Title key for UpdateSO API.

= 1.0.2 =
* Added Signatured based API authentication.

= 1.0.1 =
* Added HSCODE and Unit Price in Shipment.

= 1.0.0 =
Initial stable release — recommended for all users.

== Privacy Policy ==

This plugin:

* Stores Aramex token securely
* Sends order and shipment data to Aramex for fulfillment
* Does **not** send sensitive user data elsewhere

== Support ==

For help & onboarding, contact:
* Aramex Support: https://www.aramex.com/sa/en/support/help-center

== Credits ==

* Built by Aramex
* Follows WordPress Coding Standards & WooCommerce API guidelines

== License ==

This plugin is licensed under GPL v2 or later.
See https://www.gnu.org/licenses/gpl-2.0.html