=== 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.4
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)? =
Home Delivery supports international shipping. For non-HR countries, the plugin checks country eligibility via the Overseas Express API at checkout and shows an error if the destination is not supported. Pickup points are currently available in supported regions only.

= 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

= 1.0.2 =
* Fixed return document shipment issue

= 1.0.3 =
* Added - Approximate Location Check Added
* Fixed - Location Availability Removed in Parcel Shop Location Selection

= 1.0.4 =
* Added international shipping eligibility check for Home Delivery method
* Added WooCommerce Blocks checkout support for country eligibility validation
* Orders to non-HR countries are now validated against the Overseas Express API before checkout is allowed

---

== Upgrade Notice ==

= 1.0.1 =
Initial release.

= 1.0.2 =
Return Document Shipment Issue.

= 1.0.3 =
Location Check Issue.

= 1.0.4 =
Adds international shipping eligibility validation and WooCommerce Blocks checkout support. Upgrade recommended for all stores using block-based checkout or shipping to non-HR countries.

---

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