=== 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.3.0 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 ✔ Optional weight-based dynamic pricing tiers for Pickup and Home Delivery ✔ Optional maximum parcel size limit for weight-based Pickup --- == 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 = 1.1.0 = * Added "Pickup Shipment (Weight-Based)" and "Home Delivery Shipment (Weight-Based)" shipping methods * Added dynamic, admin-configurable price tiers by parcel weight (e.g. 0-3000g / 3000-6000g brackets, each with its own price) * Added optional maximum parcel size (length + width + height) limit for the weight-based Pickup method * The new methods reuse the existing pickup-point map and Home Delivery courier API eligibility checks = 1.2.0 = * Weight tiers on the weight-based methods are now grouped per destination country, with a "Default" group as the fallback for any country without an explicit override * Weight-based methods and their original counterparts can no longer both be enabled at the same time * Weight-based methods now hide themselves at checkout if cart items are missing Weight/Dimensions data, unless the cart already qualifies for free shipping = 1.2.1 = * Fixed bulk label printing on the Orders list silently doing nothing on some setups, and made all bulk label failures (missing shipment, API/label errors) show a clear on-screen message * Changed the "cargo" flag to false when creating a new shipment = 1.3.0 = * Internal refactor only, no functional changes: the plugin's single large file was split into an includes/ directory (one file per shipping method, plus shared helpers/traits) for maintainability --- == 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. = 1.1.0 = Adds two new weight-based shipping methods (Pickup and Home Delivery) with dynamic price tiers. Existing Pickup Shipment and Home Delivery Shipment methods are unchanged. = 1.2.0 = Weight-based pricing is now configured per destination country. If you already set up weight tiers under 1.1.0, you'll need to re-enter them under the new "Country & Weight-Based Pricing" field (as the "Default" country group) since the pricing structure changed. = 1.2.1 = Fixes bulk label printing on the Orders list silently doing nothing on some setups, and changes the "cargo" flag to false on shipment creation. Upgrade recommended for all stores using bulk label printing. = 1.3.0 = Internal code restructure only — no settings, behavior, or shipping method IDs changed. Safe to upgrade; no action needed. --- == Notes == This plugin is not an official WordPress.org or WooCommerce plugin. Overseas Express owns all rights to its API service.