Abdullah Techs Courier Booking for WooCommerce
Book, track and manage PostEx courier shipments directly from WooCommerce orders. Reusable across multiple sites — just enter your PostEx API token per site in the settings screen.
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/abdullah815/abdullah-techs-courier-booking-for-woocommerce/archive/refs/heads/main.zipCourier Booking for WooCommerce
Book, track and manage PostEx courier shipments directly from WooCommerce orders — reusable across as many WooCommerce sites as you need. Each site keeps its own PostEx API token (entered in the plugin's Settings screen); nothing is hardcoded, so the same plugin code runs unmodified anywhere you install it.
This is an independent, third-party integration. It is not affiliated with or endorsed by PostEx.
Features
- Orders tab — every WooCommerce order in one table, with live PostEx booking status and one-click Book / Refresh / Cancel / Download Label.
- Add Booking tab — an editable review grid (name, phone, address, city, COD, weight, type) for every unbooked order before it's submitted. City is a dropdown of PostEx's actual serviceable cities — catching a mismatched city name (a common cause of a booking API 400) before submission instead of after. Empty or unmatched fields are visually flagged.
- Auto-generated shipping labels — fetched and saved as a PDF automatically right after a successful booking.
- Bulk booking from either the Orders list or the Add Booking grid.
- Optional auto-booking when an order reaches a status you choose.
- Tracking sync every 30 minutes via WP-Cron, or instantly through an optional webhook endpoint.
- HPOS-compatible (WooCommerce's High-Performance Order Storage).
Requirements
- WordPress 6.0+
- WooCommerce 6.0+
- PHP 7.4+
- A PostEx Merchant account and API token
Installation
From a release zip
- Download the latest release zip.
- In WordPress admin: Plugins → Add New → Upload Plugin.
- Activate, then go to Courier Booking → Settings and add your PostEx API token.
From source (for development)
git clone https://github.com/<your-username>/abdullah-techs-courier-booking-for-woocommerce.git
Copy (or symlink) the folder into wp-content/plugins/ on a WordPress
install with WooCommerce active, then activate it from the Plugins screen.
Before going live
Confirm the exact PostEx Merchant API endpoint paths, auth header name, and payload/response field names against your current PostEx API documentation — these can change between API versions. The relevant code lives in:
includes/class-cbwc-api.php— all outbound HTTP calls to PostExincludes/class-cbwc-order.php— order → booking payload mappingincludes/class-cbwc-label.php— label/invoice PDF fetch & storage
Project structure
abdullah-techs-courier-booking-for-woocommerce.php Main plugin bootstrap
uninstall.php Cleanup on uninstall
includes/ All PHP classes (one per file)
admin/
css/, js/ Admin screen assets
views/ PHP view templates
readme.txt WordPress.org plugin readme
Contributing
Issues and pull requests are welcome. Please keep changes scoped and include a short description of what you tested.
License
GPLv2 or later — see LICENSE.