=== Galina Express Logistics Integration ===
Contributors: galinaexpress
Tags: woocommerce, logistics, shipping, tracking, delivery
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Complete WooCommerce integration with Galina Express logistics API for automated shipment creation, tracking, and management.

== Description ==

This plugin connects WooCommerce to Galina Express logistics services.

Features:
* Automated shipment creation from WooCommerce orders
* Shipment tracking and status synchronization
* COD (Cash on Delivery) support
* Delivery, Pickup, and Pickup & Delivery service types
* Auto-created shipments are limited to Iraq destination orders
* WooCommerce Shipping Zone method: "Galina Express"

External service usage:
* This plugin connects to the Galina Express API service to create and track shipments.
* Service information: https://galinaexpress.com/services/
* Privacy policy: https://galinaexpress.com/privacy-policy-2/
* Service terms/commercial terms are provided by Galina Express through their service channels: https://galinaexpress.com/ (contact: hello@galinaexpress.com).
* Data sent to the service includes shipment payload fields required for logistics operations (customer name, phone, delivery address, order identifiers, package/payment/shipment details).
* Requests are sent only after the store admin configures API credentials and uses shipment features (manual or automatic shipment creation/tracking/status sync).
* Leaflet map library files are bundled with the plugin and loaded locally.
* Checkout asks for explicit user consent before loading the interactive map.
* If consent is given, the map loads OpenStreetMap tile images from `https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png` to help select delivery coordinates. No OpenStreetMap account is required.
* If consent is not given, location can still be provided via browser geolocation or manual coordinates.

== Installation ==

1. Upload the `plugin-galina-logistic` folder to `/wp-content/plugins/`.
2. Activate the plugin from **Plugins** in WordPress admin.
3. Open **Galina Logistics** settings and configure:
   * API Base URL
   * API Key
   * Tenant ID
   * Supplier ID
4. Save settings and test API connection.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and active.

= How do shipping fees appear at checkout? =

Shipping fees are configured in WooCommerce Shipping Zones. This plugin manages shipment creation and tracking.

= Which destination country is used for auto-shipment creation? =

Auto-shipment creation is fixed to Iraq (`IQ`) destination orders.

= Does this plugin expose a public tracking endpoint? =

Yes, for shipment tracking only. Access requires a signed and expiring tokenized URL generated by the plugin from the order details page.

== Changelog ==

= 1.0.0 =
* Initial public release
* WooCommerce shipment integration
* Tracking and status synchronization
* COD and service type support
