Kitgenix Order Tracking for WooCommerce

Kitgenix Order Tracking for WooCommerce adds shipment tracking to WooCommerce orders so store staff can record one or more parcels, allocate order items to shipments, include tracking details in customer emails and offer a self-service tracking page. The plugin is intentionally different from a live carrier-management platform. It stores the tracking number, selected carrier, tracking URL and staff-managed shipment status; it does not call courier APIs to obtain live delivery scans and it does not buy labels or book collections. That makes it suitable for stores that already fulfil orders through their preferred courier workflow but need a consistent place in WooCommerce to record and communicate tracking information. Built by Kitgenix. WooCommerce Shipment Tracking Features

• Add multiple shipments to one WooCommerce order.
• Store a tracking number and carrier for each shipment.
• Allocate specific order items and quantities to a shipment.
• Prevent allocated quantities exceeding what the customer ordered.
• Use built-in carrier tracking URL patterns.
• Create custom carrier entries for services not included by default.
• Track staff-managed shipment states including shipped, in transit, delivered, exception, returned and cancelled.
• Add tracking information to supported WooCommerce customer emails.
• Provide a dedicated partially-shipped workflow/status/email where configured by the plugin.
• Give customers a self-service order tracking page.
• Support a public tracking form with order-identification checks.
• Show tracking information in My Account for authenticated customers.
• Provide tracking analytics/reporting in wp-admin.
• Import/export tracking information in supported bulk workflows.
• Optional map presentation using OpenStreetMap tiles and Nominatim geocoding.
• Developer hooks/filters for extending carrier and tracking behaviour.
• Declare WooCommerce HPOS compatibility.

Multiple Shipments and Partial Fulfilment An order can contain more than one shipment. Each shipment has its own tracking number, carrier and status, making the plugin suitable for split parcels, backordered lines, replacements or orders dispatched from more than one fulfilment location. Items and quantities can be assigned to an individual shipment. Allocation is bounded by the quantities actually ordered, so the tracking UI cannot legitimately claim that more units were shipped than exist on the order line. The remaining/unallocated items can continue to represent what has not yet been included in a parcel. Shipment Statuses The plugin defines internal tracking states including:

• Shipped.
• In transit.
• Delivered.
• Exception.
• Returned.
• Cancelled.

These values are controlled by store staff or other code that integrates with the plugin. They are not automatically fetched from Royal Mail, DPD, UPS, FedEx or another courier. That distinction is important: a "Delivered" status in the plugin means the WooCommerce store has set that status, not that Kitgenix independently confirmed delivery with the carrier. Built-In and Custom Carriers The carrier manager includes a set of ready-made carriers with tracking URL patterns. The codebase includes services for the UK, Ireland and international markets, including Royal Mail, Parcelforce/related services represented in the carrier set, DPD, An Post, DHL, UPS, FedEx, USPS, Canada Post, Australia Post, NZ Post and others. A custom/Other carrier option is available where a courier is not built in. A custom tracking URL pattern can contain the tracking-number placeholder so customer links still lead to the relevant courier tracking page. Customer Email Notifications Tracking information can be inserted into WooCommerce email flows. The plugin also includes a dedicated email class/workflow for partially shipped orders so customers can be informed when only part of an order has been dispatched. Because tracking data is stored on the WooCommerce order, customer-facing output can reuse the same shipment records rather than staff copying numbers into several separate systems. Self-Service Tracking Page The frontend tracking experience lets a customer look up tracking information using supported order-identification details. Logged-in customers can see order-related tracking through My Account, while the public form validates the supplied order data before showing sensitive order context. The output intentionally limits customer information rather than exposing a full order record to anyone who guesses an order number. A shortcode is registered for the tracking form: [kitgenix_tracking_form] Tracking Analytics The plugin includes an admin analytics area for reviewing shipment/tracking activity. Reporting is based on the tracking data stored with WooCommerce orders; it is not a remote courier analytics product and does not profile visitors across websites. Optional Route Map Where enabled by the frontend template/settings, the tracking page can display a simple map between the store origin and customer destination. The browser uses the bundled Leaflet library with OpenStreetMap map tiles and can query the public Nominatim geocoding service to translate the displayed addresses into coordinates. The map is illustrative. The code draws a straight line between geocoded points; it is not a live courier route, vehicle location or turn-by-turn delivery route. No Google Maps API key is required by this implementation. Bulk Portability The plugin includes import/export functionality for tracking records so stores can move or update shipment information in bulk rather than editing every order manually. Administrators should test bulk imports on a staging copy first when mapping external fulfilment data, especially when orders can have multiple shipments or item allocations. Privacy and Data Shipment records are stored with WooCommerce orders. The plugin does not send tracking records to a Kitgenix tracking service. Clicking a courier link takes the customer to that carrier's own website, which then operates under the carrier's own privacy terms. If the optional route map is used, address text is sent from the customer's browser to the configured Nominatim endpoint for geocoding and map tiles are requested from OpenStreetMap infrastructure. Those services are documented in External Services below. What This Plugin Does Not Do

• It does not buy or print shipping labels.
• It does not book courier collections.
• It does not pull live tracking scans from carrier APIs.
• It does not automatically know when a parcel is delivered unless another user/integration updates the status.
• It does not replace a warehouse management or fulfilment platform.

Typical Uses

• WooCommerce stores that dispatch with several different couriers.
• Orders split into multiple parcels.
• Partial shipments where customers need to know which items have left.
• Support teams that want tracking visible in the order instead of private notes.
• Stores that want a branded self-service tracking lookup without a hosted Kitgenix account.

2.2.0 (30 October 2026)

• Fix: The order number and email lookup now works for stores using a sequential or custom order-number plugin (for example WebToffee/Skyverge Sequential Order Numbers, Algoritmika Custom Order Numbers, or Kitgenix MultiStore Sync's own network order numbers). The lookup previously called wc_get_order() directly on the submitted number, which only accepts the order's internal ID, so a customer entering the order number actually shown to them could never find their order. The submitted number is now resolved the same way WooCommerce's own order-tracking shortcode does, through the woocommerce_shortcode_order_tracking_order_id filter, with a fallback to a short list of known order-number meta keys (filterable via kitgenix_order_tracking_for_woocommerce_order_number_meta_keys) before falling back to the raw internal ID.
• New: Branded My Account Tracking Panel. Display shipments and status details directly within WooCommerce My Account order views. Each shipment shows its carrier, a status badge, the tracking number, a shipment timeline, the items it contains and a "Track with carrier" button. The panel can be turned off with the kitgenix_order_tracking_for_woocommerce_show_my_account_panel filter, and its accent colour changed with the kitgenix_order_tracking_for_woocommerce_my_account_accent_color filter.
• Improved: The My Account shipment timeline no longer shows a permanently greyed-out "In transit" step for shipments staff never manually advance. Any shipment that hasn't reached a final status (delivered, exception, returned or cancelled) now ends in a single open "On its way"/"In transit" step with a subtle pulsing indicator, so it reads as active progress instead of a stalled tracker. The "Track with carrier" button is also more prominent, since the carrier's own site remains the source of live scan updates.
• Security: Fixed an issue where, for an order with no postcode stored, a lookup using only a tracking number could show the order's full billing and shipping addresses. These details are now only shown after an order number and billing email lookup, or once the postcode is confirmed.
• Security: Added rate limiting to the tracking form. Failed lookups are limited per IP address (20 every 15 minutes), and an individual order is temporarily locked after 5 incorrect email or postcode attempts, so the postcode check cannot be brute-forced. Both limits can be changed with the kitgenix_order_tracking_for_woocommerce_max_failed_lookups_per_ip and kitgenix_order_tracking_for_woocommerce_max_failed_lookups_per_order filters.
• Security: The tracking form now shows the same message when an order does not exist and when the email does not match, so it can no longer be used to discover which order numbers exist.
• Security: Shipment CSV exports now neutralise spreadsheet formula injection by prefixing values that start with =, +, -, @, a tab or a carriage return with an apostrophe. Shipment CSV imports remove it again automatically, so exported files import back unchanged.
• Improved: Raised the minimum PHP version to 8.2 (Requires PHP: 8.2).
• Improved: Tested up to WordPress 7.4 and WooCommerce 11.2.1, and reviewed for compatibility with PHP 8.2 to 8.5. The full codebase passes syntax checks on PHP 8.5 and a PHPCompatibility scan for PHP 8.2–8.5, and uses no dynamic properties or functions deprecated in PHP 8.2–8.5.
• Improved: Declared compatibility with the WooCommerce Cart and Checkout blocks (cart_checkout_blocks), so WooCommerce no longer lists the plugin as possibly incompatible in the Checkout block editor.
• Fix: The CSV $escape argument is now passed explicitly in the shipment CSV export and bulk tracking CSV import, preventing "the $escape parameter must be provided" deprecation notices on PHP 8.4 and later. The CSV format is unchanged.
• Dev: Removed the PluginScore verification code from the readme, as Kitgenix Plugin Score has been discontinued.
• Dev: Bumped the version to 2.2.0 across the plugin.
• Documentation: Regenerated the .pot translation template for 2.2.0.
• Documentation: The readme changelog now lists only the current release. The full release history is in CHANGELOG.md.

Full release history is available in the plugin's CHANGELOG.md file.