Cancelled.<\/li>\n<\/ul>\n\nThese 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.<\/p>\n\n
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.<\/p>\n\n
Built-In and Custom Carriers<\/h4>\n\n
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.<\/p>\n\n
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.<\/p>\n\n
Customer Email Notifications<\/h4>\n\n
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.<\/p>\n\n
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.<\/p>\n\n
Self-Service Tracking Page<\/h4>\n\n
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.<\/p>\n\n
The output intentionally limits customer information rather than exposing a full order record to anyone who guesses an order number.<\/p>\n\n
A shortcode is registered for the tracking form:<\/p>\n\n
[kitgenix_tracking_form]\n<\/code><\/pre>\n\nTracking Analytics<\/h4>\n\n
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.<\/p>\n\n
Optional Route Map<\/h4>\n\n
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.<\/p>\n\n
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.<\/p>\n\n
No Google Maps API key is required by this implementation.<\/p>\n\n
Bulk Portability<\/h4>\n\n
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.<\/p>\n\n
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.<\/p>\n\n
Privacy and Data<\/h4>\n\n
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.<\/p>\n\n
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<\/strong> below.<\/p>\n\nWhat This Plugin Does Not Do<\/h4>\n\n\n- It does not buy or print shipping labels.<\/li>\n
- It does not book courier collections.<\/li>\n
- It does not pull live tracking scans from carrier APIs.<\/li>\n
- It does not automatically know when a parcel is delivered unless another user\/integration updates the status.<\/li>\n
- It does not replace a warehouse management or fulfilment platform.<\/li>\n<\/ul>\n\n
Typical Uses<\/h4>\n\n\n- WooCommerce stores that dispatch with several different couriers.<\/li>\n
- Orders split into multiple parcels.<\/li>\n
- Partial shipments where customers need to know which items have left.<\/li>\n
- Support teams that want tracking visible in the order instead of private notes.<\/li>\n
- Stores that want a branded self-service tracking lookup without a hosted Kitgenix account.<\/li>\n<\/ul>\n\n
Developers<\/h3>\n\n
Text domain:\nkitgenix-order-tracking-for-woocommerce<\/p>\n\n
Shortcode:\n[kitgenix_tracking_form]<\/p>\n\n
Data model (high level):\n- Shipments are stored as order meta under _kitgenix_tracking_shipments<\/code> (array)\n- Tracking numbers are indexed for fast lookup via repeated order meta _kitgenix_tracking_number<\/code> (one meta row per tracking number)\n- Each shipment can also store a status<\/code> value (shipped, in_transit, delivered, exception, returned, cancelled) for admin records and analytics \u2013 this is set by staff, not fetched from a carrier\n- Admin UI stores the last chosen \"update order status\" action as order meta kitgenix_order_status_action<\/code> (values: no_change<\/code>, partial<\/code>, completed<\/code>)\n- Carrier settings are stored in the option kitgenix_order_tracking_for_woocommerce_carriers_settings<\/code>\n- Counter option: kitgenix_order_tracking_for_woocommerce_tracking_numbers_added<\/code> (privacy-safe total)\n- Counter option: kitgenix_order_tracking_for_woocommerce_lookup_count<\/code> (successful tracking-page lookups)\n- Event log option: kitgenix_order_tracking_event_log<\/code>\n- Analytics aggregates are cached briefly in transients prefixed kitgenix_order_tracking_for_woocommerce_analytics_...<\/code>\n- Activation redirect uses transient kitgenix_order_tracking_for_woocommerce_do_activation_redirect<\/code> (about 30 seconds)\n- No custom database tables are created\n- No custom post types, taxonomies, or REST API routes are registered by this plugin\n- Uninstall does not remove order meta or shipment data (to preserve historical tracking) \u2013 see Uninstall behaviour below<\/p>\n\nNonces \/ capabilities (summary):\n- Order edit tracking save uses nonce action kitgenix_order_tracking_save<\/code> (kitgenix_order_tracking_nonce<\/code>) and requires edit_shop_order<\/code>.\n- Order-items modal loads via AJAX action kitgenix_order_tracking_for_woocommerce_get_order_items<\/code> using nonce action kitgenix_order_tracking<\/code>.\n- Tracking form submissions use nonce action kitgenix_tracking_lookup<\/code> (kitgenix_tracking_nonce<\/code>).\n- Carriers (Shippers) settings form uses nonce action kitgenix_order_tracking_for_woocommerce_save_carriers<\/code> (kitgenix_order_tracking_for_woocommerce_carriers_nonce<\/code>).\n- CSV export\/import on the Bulk Tools tab use the kitgenix_order_tracking_export_shipments<\/code> and kitgenix_order_tracking_import_shipments<\/code> nonce actions and require the plugin's admin capability (manage_woocommerce<\/code>, or manage_options<\/code> if WooCommerce management capabilities aren't available).<\/p>\n\nHooks \/ filters:\n- kitgenix_order_tracking_shipment_created( int $order_id, array $shipment ) (action, fires after a new shipment is saved)\n- kitgenix_order_tracking_shipment_updated( int $order_id, array $shipment, array $previous_shipment ) (action, fires after an existing shipment is changed)\n- kitgenix_order_tracking_shipment_deleted( int $order_id, array $shipment ) (action, fires after a shipment is removed)\n- kitgenix_order_tracking_shipment_notification_sent( int $order_id, string $email_id ) (action, fires after the Partially Shipped email is sent)\n- kitgenix_order_tracking_for_woocommerce_debug_save( bool $enabled, int $order_id ): bool (filter, enable a debug order note on save)\n- kitgenix_order_tracking_for_woocommerce_nominatim_email( string $email ): string (filter, supply\/override the Nominatim contact email param)\n- kitgenix_order_tracking_for_woocommerce_nominatim_endpoint( string $endpoint ): string (filter, override the geocoding endpoint)<\/p>\n\n
Templates:\n- The custom Partially Shipped email uses standard WooCommerce template override patterns via the files in templates\/emails\/<\/code> and templates\/emails\/plain\/<\/code>.<\/p>\n\nAdmin AJAX endpoints:\n- wp_ajax_kitgenix_order_tracking_for_woocommerce_get_order_items (load order items into the shipment modal)<\/p>\n\n
Uninstall behaviour:\n- Removed on uninstall: the carrier settings option, the tracking-numbers-added and lookup-count counter options, the event log option, and all plugin-prefixed transients (including any Kitgenix hub caches described below); the same options are also cleaned up per-site on multisite.\n- Not removed on uninstall: order meta (_kitgenix_tracking_shipments<\/code>, _kitgenix_tracking_number<\/code>) and the \"Partially shipped\" order status\/history stay on your orders, so historical tracking data and reporting are preserved even after the plugin is removed.<\/p>\n\nExternal Services<\/h3>\n\n
This plugin may connect to external services in three situations:<\/p>\n\n
1) When customers click courier tracking links\nTracking links open the carrier's own tracking page (e.g. Amazon Logistics, An Post, DHL, DPD, DX, Evri, FedEx, Parcelforce Worldwide, Royal Mail, UPS, Woodside Distribution, Yodel, or a custom \"Other\" URL you configure). These links may contain the tracking number. The plugin does not call any carrier API on its own \u2013 it never fetches live delivery status from a courier.<\/p>\n\n
2) When the optional route map is enabled\nThe tracking view may request:\n- OpenStreetMap tile images, from https:\/\/{s}.tile.openstreetmap.org\/{z}\/{x}\/{y}.png<\/code>.\n- Nominatim geocoding requests, to convert store and customer address details into map coordinates. This defaults to https:\/\/nominatim.openstreetmap.org\/search<\/code> and may include the full store and delivery address string in the q<\/code> parameter. A developer filter lets you override the endpoint and supply a contact email for the request.\nLeaflet (the mapping library) is bundled with the plugin \u2013 no CDN or external script is loaded to render the map itself.<\/p>\n\n3) In wp-admin (Kitgenix hub)\nThis plugin includes a shared \"Kitgenix hub\" admin page that helps you find and manage other Kitgenix plugins. It uses WordPress core's plugins_api()<\/code> function to fetch publicly available plugin listing data from the WordPress.org Plugins API (wordpress.org) \u2013 active install counts, ratings, and icon\/banner artwork \u2013 for a fixed list of Kitgenix plugin slugs. No site content, order data, or personal data is sent as part of these requests; results are cached in transients for up to 24 hours (kitgenix_hub_wporg_active_installs_v1<\/code>, kitgenix_hub_wporg_ratings_v1<\/code>, kitgenix_hub_wporg_media_v1<\/code>) to minimise repeat calls.<\/p>\n\nNo personal data is sold or shared by this plugin. Where external services are used, requests may include data required to perform the function (for example, a tracking number in a carrier link, or address data used for geocoding). Review the relevant provider's own privacy policy for your use case.<\/p>\n\n
Trademark Notice<\/h3>\n\n
All carrier names and logos are trademarks of their respective owners. This plugin is not affiliated with or endorsed by any courier, carrier, OpenStreetMap, or Nominatim service.<\/p>\n\n
Support Development<\/h3>\n\n
If this plugin reduces \"where is my order?\" tickets and helps customers self-serve tracking, you can support ongoing development with a donation via PayPal:\nhttps:\/\/www.paypal.com\/donate\/?hosted_button_id=KALF36K6JJ9B2<\/p>\n\n
Credits<\/h3>\n\n
Built with \u2764\ufe0e by @kitgenix - https:\/\/kitgenix.com<\/p>\n\n\n
\n- Install and activate WooCommerce if you haven't already \u2013 this plugin will not activate without it.<\/li>\n
- Install this plugin via Plugins \u2192 Add New (search for \"Kitgenix Order Tracking for WooCommerce\"), or upload the ZIP file to \/wp-content\/plugins\/ and activate it.<\/li>\n
- Create a page (e.g. \"Track Your Order\") and add the shortcode:\n [kitgenix_tracking_form]<\/li>\n
- Open any WooCommerce order and use the Kitgenix Order Tracking meta box to add a shipment.<\/li>\n
- Send a Completed Order email (or use the Partially Shipped status) to confirm tracking appears correctly.<\/li>\n
- Optional: visit Kitgenix \u2192 Order Tracking \u2192 Carriers to apply a regional carrier pack, and \u2192 Bulk Tools if your fulfilment team needs CSV import\/export.<\/li>\n<\/ol>\n\n\n
\nDoes this plugin require WooCommerce?<\/h3><\/dt>\nYes. WooCommerce must be installed and active. If WooCommerce isn't active, the plugin deactivates itself automatically and shows a notice.<\/p><\/dd>\n
Can I add multiple tracking numbers to one order?<\/h3><\/dt>\nYes. Add as many shipments as you need per order, including split parcels and partial shipments, each with its own carrier and tracking number.<\/p><\/dd>\n
Does the plugin fetch live tracking status from couriers?<\/h3><\/dt>\nNo. It stores the tracking number and links to the carrier's own tracking page. Any shipment status shown in the admin or analytics (Shipped, In transit, Delivered, etc.) is set manually by your staff \u2013 the plugin does not call carrier APIs.<\/p><\/dd>\n
Which couriers are supported?<\/h3><\/dt>\nBuilt-in carriers include Amazon Logistics, An Post, Australia Post, Bpost, Canada Post, Chronopost, Colissimo\/La Poste, Correos, DHL, Deutsche Post\/DHL Germany, DPD Ireland, DPD UK, DX, Evri, FedEx, GLS, NZ Post, Parcelforce Worldwide, PostNL, PostNord, Royal Mail, UPS (US, Ireland, UK), USPS, Woodside Distribution, and Yodel, plus an \"Other\" option for custom links.<\/p><\/dd>\n
Can I use a courier that isn't listed?<\/h3><\/dt>\nYes. Use Kitgenix \u2192 Order Tracking \u2192 Carriers to add a custom carrier with its own tracking URL pattern (using {tracking_number}<\/code>) and icon, or select \"Other\" when adding tracking to an order.<\/p><\/dd>\nDoes the plugin guess the carrier for me?<\/h3><\/dt>\nIt can suggest one for tracking numbers with a distinctive, unambiguous format (UPS's \"1Z\" prefix, Amazon Logistics' \"TBA\" prefix, Royal Mail\/Parcelforce and USPS formats). This is always shown as an unconfirmed suggestion \u2013 it never overwrites a carrier you've explicitly chosen, and ambiguous numeric formats are left unmatched rather than guessed.<\/p><\/dd>\n
Can I import or export tracking in bulk?<\/h3><\/dt>\nYes. The Bulk Tools tab exports all tracked shipments to CSV and lets you re-import edited files, either appending new shipments or replacing all shipments on the matched orders. Per-item quantities round-trip using an item_id:qty|item_id:qty<\/code> format.<\/p><\/dd>\nDo customers get tracking in emails automatically?<\/h3><\/dt>\nYes, once a shipment exists on the order. Tracking appears in the WooCommerce Completed Order email and in the plugin's Partially Shipped email.<\/p><\/dd>\n
What is the \"Partially shipped\" order status and email?<\/h3><\/dt>\nThe plugin adds a custom order status, \"Partially shipped\", and a matching customer email. It's designed for stores that ship orders in stages and want to notify customers with tracking before the whole order is complete.<\/p><\/dd>\n
Can customers track an order without logging in?<\/h3><\/dt>\nYes. The [kitgenix_tracking_form]<\/code> tracking page is public and supports lookup by order number and billing email, or by tracking number alone.<\/p><\/dd>\nWhy can't a customer see the full address or item details on the tracking page?<\/h3><\/dt>\nFor privacy, full addresses, the route map, and item-level shipment detail are only shown after the customer confirms the postcode, ZIP code, or postal code stored on the order. This check uses country-aware matching, not a single fixed postcode format.<\/p><\/dd>\n
Does the plugin work with WooCommerce High-Performance Order Storage (HPOS)?<\/h3><\/dt>\nYes. The plugin declares HPOS compatibility and its order meta box and save logic work on both the classic and HPOS order-edit screens.<\/p><\/dd>\n
Do I need a Google Maps API key for the route map?<\/h3><\/dt>\nNo. The optional map uses Leaflet (bundled with the plugin) and OpenStreetMap tiles, with no API key or CDN required.<\/p><\/dd>\n
The route map isn't showing \u2013 what should I check?<\/h3><\/dt>\nCheck for a strict Content Security Policy or aggressive script\/asset optimisation that might block the bundled Leaflet script or the OpenStreetMap tile and geocoding requests.<\/p><\/dd>\n
Does this plugin create shipping labels or replace a fulfilment system?<\/h3><\/dt>\nNo. It records tracking numbers you already have and displays them to customers; it doesn't generate labels, rates, or replace a fulfilment\/shipping suite.<\/p><\/dd>\n
Is this plugin GDPR-friendly?<\/h3><\/dt>\nIt doesn't set tracking cookies and uses WooCommerce's existing order data for lookups. Carrier tracking links and the optional map's tile\/geocoding requests are external services \u2013 review their own privacy policies for your needs.<\/p><\/dd>\n
Does this plugin talk to any other Kitgenix plugins or a remote Kitgenix server?<\/h3><\/dt>\nNo customer or store data is sent to Kitgenix. The plugin adds an optional \"Kitgenix\" admin page that can look up publicly available plugin listing information (install counts, ratings, icons) from WordPress.org for other Kitgenix plugins, to help you find and manage them \u2013 see External Services below.<\/p><\/dd>\n\n<\/dl>\n\n\n
2.0.0 (31 August 2026)<\/h4>\n\n\n- New: Redesigned the entire admin experience around the shared Kitgenix design system \u2013 a sticky topbar with an Analytics dropdown menu, live settings search, dark\/light theme toggle, and mobile hamburger menu replaces the previous page header and tab strip.<\/li>\n
- New: Added a redesigned central Kitgenix Hub page for discovering, installing, activating, and reviewing every Kitgenix plugin from one screen, including the new Image Optimizer plugin.<\/li>\n
- Improved: Rebuilt the Analytics, Carriers, Bulk Tools, Support, and Log tabs around a consistent set of cards, toggle switches, colour-coded status badges, empty states, and a drag-and-drop CSV upload zone, replacing the previous form tables and plain links.<\/li>\n
- Improved: The Tracking Analytics stat-tile grid \u2013 including orders in range, time-to-ship, lookups, and other metrics \u2013 now uses a fixed four-column layout on wider screens, with responsive fallbacks to two columns and then one column on smaller displays.<\/li>\n
- Improved: The \"Add tracking\" modal on the WooCommerce order edit screen and the custom carrier edit modal now share a common accessible modal component with proper focus handling, Escape-to-close support, and accessible labelling.<\/li>\n
- Improved: Custom carrier rows now use compact icon-only edit and delete action buttons with colour-coded enabled\/disabled badges instead of plain text links.<\/li>\n
- Improved: The Log tab now displays entries in a searchable, paginated table containing time, context, outcome, and a plain-English note instead of a plain text block.<\/li>\n
- Improved: CSV bulk import failures now record the specific underlying reason \u2013 including unreadable files, files that cannot be opened, missing or invalid headers, and unexpected processing errors \u2013 in the Log tab alongside the existing on-screen message.<\/li>\n
- Improved: Added a reference table to the Log tab explaining what each recorded category means and whether administrator action is required.<\/li>\n
- Improved: The Support tab is now three focused cards \u2013 a donate card with a collapsible monthly-amount picker, a \"what your support funds\" summary, and a \"get involved\" panel for reviews and plugin links \u2013 replacing the previous stack of donate, trust, and community cards.<\/li>\n
- Improved: Moved the Log tab directly before Support in the admin navigation for a more logical workflow.<\/li>\n
- Improved: Refreshed the Kitgenix logo and favicon assets used throughout the admin menu icon, Kitgenix Hub header, and Analytics header.<\/li>\n
- Fix: The \"Follow Us\" social links no longer appear twice on the Support tab, removing the previous duplication between the inline social block and sidebar.<\/li>\n
- Fix: The \"Shipments over time\" sparkline no longer displays a bold solid line when there is no shipment data. Empty charts now render a thinner, muted baseline so the absence of data cannot be mistaken for a genuine flat trend.<\/li>\n
- Fix: Number inputs across the Analytics and settings screens are no longer cramped to a fixed 50px width.<\/li>\n
- Dev: Added a shared
kitgenix-admin-components.js<\/code> controller providing modal open\/close handling, toast notifications, collapsible cards, copy-to-clipboard controls, and live table search. Both admin-analytics.js<\/code> and admin-order-tracking.js<\/code> now use the shared component controller.<\/li>\n- Dev: Three previously silent internal errors \u2013 Analytics date parsing, tracking-count lookups, and HPOS order-screen detection \u2013 are now recorded in the Log tab for easier diagnostics while remaining non-blocking and preserving existing behaviour.<\/li>\n<\/ul>","raw_excerpt":"Add WooCommerce shipment tracking, multiple parcels, tracking emails and a self-service customer tracking page.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/264398","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=264398"}],"author":[{"embeddable":true,"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kitgenix"}],"wp:attachment":[{"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=264398"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=264398"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=264398"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=264398"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=264398"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/es-ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=264398"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}