=== Overseas Express Shipment ===
Contributors: itoverseas
Tags: shipping, woocommerce, delivery, courier, pickup points
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

WooCommerce integration with Overseas Express Pickup Point and Home Delivery shipping services.

== Description ==

This plugin integrates **Overseas Express** shipping services into **WooCommerce**, providing:

- Pickup Point map integration (Parcel Shops & Lockers)
- Home Delivery shipment calculation
- Real-time validation of delivery availability
- Automatic creation/update of shipments in Overseas Express system
- Printing of shipping labels
- Tracking link generation inside WooCommerce orders
- Multi-label bulk printing
- Separate configuration for Pickup and Home Delivery shipping methods

This plugin requires a valid Overseas Express API Key, provided by Overseas Express.

=== Features ===

✔ Pickup Point Map (Leaflet-based)  
✔ Marker-based Locker/ParcelShop selection  
✔ Automatic checkout address autofill  
✔ API validation for ZIP/City delivery availability  
✔ Create, update, and manage shipments from WP Admin  
✔ Print PDF shipping labels  
✔ COD (Cash on Delivery) support  
✔ Bulk label printing  
✔ Full WooCommerce integration  
✔ Admin settings panels for both shipment types  

---

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/overseas-express-shipment/`
2. Activate the plugin through the **Plugins** menu in WordPress
3. Go to **Integration Shipment → Main Settings**
4. Enter your **API Key** and Sender Information
5. Configure shipping zones:
   - **WooCommerce → Settings → Shipping → Pickup Shipment**
   - **WooCommerce → Settings → Shipping → Home Delivery Shipment**
6. Save settings

Pickup Map will automatically appear on checkout when the Pickup Shipment method is selected.

---

== Frequently Asked Questions ==

= Do I need an Overseas Express API key? =
Yes. You must obtain your API key from Overseas Express. Without it, the plugin cannot operate.

= Does the plugin send customer data to Overseas Express? =
Only when creating or updating a shipment, or validating a delivery address.  
This data is required to generate shipping labels and provide courier delivery.

= Does the plugin work outside Croatia (HR)? =
Pickup points are currently available in supported regions only, depending on Overseas Express API availability.

= Does the plugin modify checkout fields? =
The plugin fills in the chosen pickup point address automatically.

= Are there any front-end scripts loaded globally? =
No — Leaflet and map scripts load only on WooCommerce Checkout.

---

== Screenshots ==

1. Pickup Point Map inside checkout
2. Admin settings for Pickup Shipment
3. Admin settings for Home Delivery Shipment
4. Shipment controls inside WooCommerce Order
5. Bulk label printing panel

---

== Privacy ==

This plugin sends customer and order data to **Overseas Express API** when creating or updating a shipment.  
This includes:

- Customer name  
- Delivery address  
- Phone number  
- Email  
- Order details  
- Package weight and contents  

This data is required for postal delivery and is processed on the Overseas Express logistics platform.

No data is transmitted to any service other than **https://api.overseas.hr/**.  
No analytics, telemetry, or tracking is performed by this plugin.

Official Overseas Express Privacy Policies:

**Croatian (HR):**  
https://overseas.hr/hr/info/izjava-o-privatnosti-2

**English (EN):**  
https://overseas.hr/en/info/privacy-policy-2

By using this plugin, store owners are responsible for ensuring GDPR compliance for their shop and informing customers about the use of Overseas Express as a shipping carrier.

---

== External API Disclosure ==

This plugin communicates with the following external service:

**Service:** Overseas Express API  
**Base URL:** https://api.overseas.hr/

**Used For:**
- Fetching pickup point locations  
- Validating delivery availability  
- Creating shipments  
- Updating shipments  
- Retrieving PDF shipping labels  

No other external services are contacted.

---

== Changelog ==

= 1.0.1 =
* Added Pickup Shipment method
* Added Home Delivery Shipment method
* Added checkout map integration
* Added shipment creation and label printing
* Added admin settings pages
* Added bulk label printing

---

== Upgrade Notice ==

= 1.0.1 =
Initial release.

---

== Notes ==
This plugin is not an official WordPress.org or WooCommerce plugin.  
Overseas Express owns all rights to its API service.
