Kitgenix

<p>Customers don’t just want a tracking number — they want confidence.</p>
<p>After purchase, the questions are predictable:<br />
“Has it shipped yet?”, “Is this coming in multiple parcels?”, “Which courier is it with?”, and “Can I track it right now?”</p>
<p><strong>Kitgenix Order Tracking for WooCommerce</strong> gives you a clean, reliable way to manage <strong>WooCommerce shipment tracking</strong> without bloated shipping suites. Add <strong>multiple shipments</strong> to a single order (split deliveries, replacements, multi-parcel, different carriers), bulk import or export shipment data in CSV format for spreadsheet-based fulfilment workflows, apply international carrier packs for different regions, show tracking clearly to customers, and reduce “where is my order?” support tickets with a self-service tracking page.</p>
<p>It also includes a <strong>Tracking Analytics</strong> screen inside WooCommerce so you can understand shipping speed, exceptions, and how often customers check tracking.</p>
<h4>Built for real-world shipping workflows</h4>
<p>This plugin is especially useful if you:<br />
– ship orders in more than one box (multi-parcel / multi-shipment),<br />
– part-ship items while the rest are backordered,<br />
– manage fulfilment in spreadsheets or need to update lots of tracking numbers at once,<br />
– ship to multiple regions and need better carrier coverage than UK/Ireland-only defaults,<br />
– use multiple couriers (Amazon Logistics, An Post, DHL, DPD, DX, Evri, FedEx, Parcelforce, Royal Mail, UPS, Woodside, Yodel, etc.),<br />
– want a branded tracking page instead of sending customers to random courier sites,<br />
– want tracking shown in emails (cleanly, without duplicate blocks),<br />
– want a “Partially shipped” workflow and email for staged fulfilment.</p>
<h4>What the plugin does</h4>
<ol>
<li>Add one or more shipments to a WooCommerce order (carrier + tracking number + optional shipped date + per-item quantities).</li>
<li>Generate courier tracking links from built-in carrier URL patterns (plus an “Other” courier option for custom links).</li>
<li>Display tracking for customers:
<ul>
<li>in emails,</li>
<li>and on a public tracking page via shortcode.</li>
</ul>
</li>
<li>Optionally show an approximate delivery route map (Leaflet + OpenStreetMap; no Google Maps, no API key, no CDN).</li>
<li>Monitor operations with a Tracking Analytics dashboard (ship speed, totals, breakdowns, lookups, recent shipments).</li>
<li>Import or export shipment rows in CSV format so warehouse teams can round-trip tracking updates through Excel or Google Sheets.</li>
<li>Apply regional carrier packs and country-aware postcode / ZIP / postal-code verification for broader international use.</li>
</ol>
<h4>Key features</h4>
<h3>Multiple shipments (multi-parcel, split deliveries, replacements)</h3>
<p>Add as many shipments as you need to a single order. Each shipment can include:<br />
– carrier (optional; if omitted, no carrier tracking link is generated),<br />
– tracking number,<br />
– shipped date (optional),<br />
– shipped items + quantities (line-item allocation for partial fulfilment).</p>
<p>This makes partial shipments and multi-parcel deliveries accurate and customer-friendly.</p>
<h3>Built-in carriers (international-ready)</h3>
<p>Includes a carrier registry with icons and tracking URL patterns, so customers get direct “Track shipment” links.</p>
<p>Built-in carriers include:<br />
– Amazon Logistics<br />
– An Post<br />
– Australia Post<br />
– Bpost<br />
– Canada Post<br />
– Chronopost<br />
– Colissimo / La Poste<br />
– Correos<br />
– DHL<br />
– Deutsche Post / DHL Germany<br />
– DPD Ireland<br />
– DPD UK<br />
– DX<br />
– Evri<br />
– FedEx<br />
– GLS<br />
– NZ Post<br />
– Other (custom link / no pattern)<br />
– Parcelforce Worldwide<br />
– PostNL<br />
– PostNord<br />
– Royal Mail<br />
– UPS US<br />
– UPS Ireland<br />
– UPS UK<br />
– USPS<br />
– Woodside Distribution<br />
– Yodel</p>
<h3>Carrier management (built-in + custom)</h3>
<p>The carrier registry is configurable from Kitgenix <span aria-hidden="true" class="wp-exclude-emoji">→</span> Order Tracking <span aria-hidden="true" class="wp-exclude-emoji">→</span> Carriers:<br />
– apply recommended carrier packs for UK & Ireland, Europe, North America, Australia & New Zealand, or a global mixed-carrier setup,<br />
– enable or disable built-in carriers,<br />
– reorder carriers by priority so the most-used options appear first,<br />
– add custom carriers with their own tracking URL patterns,<br />
– upload custom carrier icons from the WordPress media library,<br />
– keep the built-in “Other” fallback available for manual links.</p>
<h3>International carrier packs and country-aware validation</h3>
<p>Stores shipping internationally often need two things at once: broader carrier coverage and customer verification that matches the destination market.</p>
<p>The plugin now includes recommended built-in carrier packs for:<br />
– UK & Ireland<br />
– Europe<br />
– North America<br />
– Australia & New Zealand<br />
– Global / mixed-carrier stores</p>
<p>Applying a carrier pack configures a recommended built-in carrier set and priority order for that region, while still letting you fine-tune carriers manually afterwards.</p>
<p>The customer tracking form now also uses country-aware postcode validation rules, so ZIP codes, postal codes, and country-prefixed formats are handled more accurately for international orders instead of assuming every market behaves like a UK postcode.</p>
<h3>Customer tracking page (self-service)</h3>
<p>Add a tracking page anywhere using:<br />
[kitgenix_tracking_form]</p>
<p>The tracking form supports:<br />
– Order-based lookup (order number + billing email, with country-aware postcode / ZIP / postal-code verification used before showing full addresses, the route map, and item details), and<br />
– Tracking-number lookup (useful when the customer only has parcel details)</p>
<p>When shipments have item allocations, the tracking results can show which items were shipped in each parcel and which items remain unshipped. Postcode verification is normalised so common spacing and punctuation differences do not block valid customer lookups.</p>
<p>Tracking-number lookups show shipment status and tracking details, but full addresses, route maps, and item-level detail stay behind postcode verification when the order includes a stored postcode.</p>
<p>Great for reducing support tickets and giving customers a consistent experience.</p>
<h3>Tracking in WooCommerce emails (done cleanly)</h3>
<p>Tracking is appended to:<br />
– WooCommerce Completed Order email, and<br />
– the plugin’s own Partially Shipped email</p>
<p>Includes duplicate-guarding so tracking blocks aren’t repeated if templates/hooks are customised.</p>
<h3>“Partially shipped” order status + email (included)</h3>
<p>The plugin registers:<br />
– a custom order status: <strong>wc-partially-shipped</strong> (“Partially shipped”), and<br />
– a custom email: <strong>Kitgenix Partially Shipped</strong></p>
<p>Ideal for stores that ship in stages and want to send tracking early without marking the whole order completed.</p>
<h3>Optional route map (OpenStreetMap + Leaflet)</h3>
<p>If enabled, the tracking view can show an approximate route map using:<br />
– Leaflet (bundled locally — no CDN),<br />
– OpenStreetMap tiles,<br />
– Nominatim geocoding (endpoint + contact email are filterable)</p>
<p>Includes fallbacks if geocoding fails (shows what it can, or hides the map with a message).</p>
<h3>Tracking Analytics dashboard (inside WooCommerce)</h3>
<p>Adds an admin screen under the Kitgenix hub with practical metrics:<br />
– shipped vs unshipped orders,<br />
– total shipments,<br />
– exceptions,<br />
– average/median time-to-ship,<br />
– carrier/status breakdowns,<br />
– recent shipments,<br />
– privacy-safe totals for tracking numbers added and successful customer lookups,<br />
– customer tracking lookup totals,<br />
– date range selection (predefined windows like 7–180 days)</p>
<p>Calculations are batched and cached briefly (transients) to keep the dashboard fast.</p>
<h3>Bulk shipment import and export</h3>
<p>Stores that process a lot of orders often work from spreadsheets rather than opening each order one by one.</p>
<p>The new Bulk Tools tab in Kitgenix <span aria-hidden="true" class="wp-exclude-emoji">→</span> Order Tracking lets you:<br />
– export tracked shipments to CSV with one row per shipment,<br />
– re-import edited CSV files to add tracking updates across many orders,<br />
– choose whether imports append new shipments or replace all shipments on matched orders,<br />
– round-trip per-item shipment quantities using the <code>item_id:qty|item_id:qty</code> format,<br />
– keep warehouse and support workflows aligned by using the exported <code>order_id</code> values for reliable imports.</p>
<p>The CSV workflow is built on top of the plugin’s existing shipment data model, so imported shipments use the same storage, tracking links, customer email rendering, analytics totals, and public tracking-page output as shipments added manually in the order screen.</p>
<h4>How it works (quick overview)</h4>
<p>1) Add tracking in wp-admin<br />
Edit an order and use the <strong>Order Tracking</strong> meta box. Create shipments using the “Add tracking” modal:<br />
– tracking number<br />
– carrier dropdown (explicit selection, or leave blank)<br />
– shipped date<br />
– item quantities (loaded via AJAX)<br />
– optional order status update after save (don’t change / partially shipped / completed)</p>
<p>2) Tracking appears for customers<br />
If shipments exist, customers see a clear “Shipment Tracking” section in key emails and via the tracking page.</p>
<p>3) Customers can track without contacting you<br />
Use the shortcode page so customers can look up tracking by order details or by tracking number.</p>
<p>4) You can measure shipping performance<br />
Open Tracking Analytics to see speed, breakdowns, and customer behaviour.</p>
<h3>Quick Start</h3>
<ol>
<li>Install and activate the plugin.</li>
<li>Create a page called “Track Your Order” (or similar).</li>
<li>Add this shortcode:<br />
[kitgenix_tracking_form]</li>
<li>Edit any order and add a shipment in the Order Tracking meta box.</li>
<li>Send a Completed Order email (or use Partially Shipped) and confirm tracking is shown.</li>
<li>Optional: use Kitgenix <span aria-hidden="true" class="wp-exclude-emoji">→</span> Order Tracking <span aria-hidden="true" class="wp-exclude-emoji">→</span> Bulk Tools when your fulfilment team needs CSV import/export workflows.</li>
<li>Optional: use Kitgenix <span aria-hidden="true" class="wp-exclude-emoji">→</span> Order Tracking <span aria-hidden="true" class="wp-exclude-emoji">→</span> Carriers to apply a regional carrier pack before fine-tuning carrier priorities.</li>
</ol>
<h3>Developers</h3>
<p>Text domain:<br />
kitgenix-order-tracking-for-woocommerce</p>
<p>Shortcode:<br />
[kitgenix_tracking_form]</p>
<p>Data model (high level):<br />
– Shipments are stored as order meta under <code>_kitgenix_tracking_shipments</code> (array)<br />
– Tracking numbers are indexed for fast lookup via repeated order meta <code>_kitgenix_tracking_number</code> (one meta row per tracking number)<br />
– Each shipment can also store a <code>status</code> value for future workflow and analytics extensions<br />
– Admin UI stores the last chosen “update order status” action as order meta <code>kitgenix_order_status_action</code> (values: <code>no_change</code>, <code>partial</code>, <code>completed</code>)<br />
– Carrier settings are stored in the option <code>kitgenix_order_tracking_for_woocommerce_carriers_settings</code><br />
– Counter option: <code>kitgenix_order_tracking_for_woocommerce_tracking_numbers_added</code> (privacy-safe total)<br />
– Counter option: <code>kitgenix_order_tracking_for_woocommerce_lookup_count</code> (successful tracking-page lookups)<br />
– Analytics aggregates are cached briefly in transients prefixed <code>kitgenix_order_tracking_for_woocommerce_analytics_...</code><br />
– Activation redirect uses transient <code>kitgenix_order_tracking_for_woocommerce_do_activation_redirect</code> (about 30 seconds)<br />
– No custom database tables are created<br />
– Uninstall does not automatically remove order meta (to preserve historical tracking)</p>
<p>Nonces / capabilities (summary):<br />
– Order edit tracking save uses nonce action <code>kitgenix_order_tracking_save</code> (<code>kitgenix_order_tracking_nonce</code>) and requires <code>edit_shop_order</code>.<br />
– Order-items modal loads via AJAX action <code>kitgenix_order_tracking_for_woocommerce_get_order_items</code> using nonce action <code>kitgenix_order_tracking</code>.<br />
– Tracking form submissions use nonce action <code>kitgenix_tracking_lookup</code> (<code>kitgenix_tracking_nonce</code>).<br />
– Carriers (Shippers) settings form uses nonce action <code>kitgenix_order_tracking_for_woocommerce_save_carriers</code> (<code>kitgenix_order_tracking_for_woocommerce_carriers_nonce</code>).</p>
<p>Hooks / filters:<br />
– kitgenix_order_tracking_for_woocommerce_debug_save( bool $enabled, int $order_id ): bool (enable debug order note on save)<br />
– kitgenix_order_tracking_for_woocommerce_nominatim_email( string $email ): string (supply/override Nominatim email param)<br />
– kitgenix_order_tracking_for_woocommerce_nominatim_endpoint( string $endpoint ): string (override geocoding endpoint)</p>
<p>Templates:<br />
– The custom Partially Shipped email uses standard WooCommerce template override patterns via the files in <code>templates/emails/</code> and <code>templates/emails/plain/</code>.</p>
<p>Admin AJAX endpoints:<br />
– wp_ajax_kitgenix_order_tracking_for_woocommerce_get_order_items (load order items into the shipment modal)</p>
<h3>External Services</h3>
<p>This plugin may connect to external services in two situations:</p>
<p>1) When customers click courier tracking links<br />
Tracking links open the carrier’s 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. These links may contain the tracking number.</p>
<p>2) When the optional map is enabled<br />
The tracking view may request:<br />
– OpenStreetMap tile images<br />
– Nominatim geocoding requests (to convert store/customer address details into coordinates)</p>
<p>Map implementation notes:<br />
– Leaflet is bundled locally (no CDN fallback).<br />
– Map tiles are loaded from <code>https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png</code>.<br />
– Geocoding defaults to <code>https://nominatim.openstreetmap.org/search</code> and may include the full store and delivery address string in the <code>q</code> parameter.</p>
<p>3) In wp-admin (Kitgenix hub)<br />
This plugin includes a shared “Kitgenix hub” component in wp-admin which may fetch publicly available plugin metadata from WordPress.org using WordPress core’s <code>plugins_api()</code> function.</p>
<p>Caching:<br />
– Transient: <code>kitgenix_hub_wporg_active_installs_v1</code><br />
– Transient: <code>kitgenix_hub_wporg_ratings_v1</code><br />
– Transient: <code>kitgenix_hub_wporg_media_v1</code></p>
<p>Leaflet assets are bundled locally (no CDN).</p>
<p>No 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 policies for your use case.</p>
<h3>Trademark Notice</h3>
<p>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>
<h3>Support Development</h3>
<p>If this plugin reduces “where is my order?” tickets and helps customers self-serve tracking, you can support ongoing development here:<br />
https://buymeacoffee.com/kitgenix</p>
<h3>Credits</h3>
<p>Built with ❤︎ by @kitgenix – https://kitgenix.com</p>


Kitgenix Order Tracking for WooCommerce

Add WooCommerce order tracking with multi-shipment support, international carriers, CSV import/export, email links, and a customer tracking page.

Matías Anca

<p>Puedes revisar la documentación oficial del plugin en <a href="https://docs.manca.com.ar/wc-cool-correo-argentino/" rel="nofollow ugc">https://docs.manca.com.ar/wc-cool-correo-argentino/</a></p>
<p>Funcionalidades:<br />
Calculadora de Envíos para Correo Argentino<br />
Envío a Sucursales y a Domicilio<br />
Cálculo de costo Manual ( por tarifario ), o automático ( directo por API a Correo Argentino )<br />
Opciones: Envío Gratuito | Recargo | Descuento | Costo Fijo<br />
Generación de archivo CSV Lote para importar en Correo Argentino<br />
Se incorpora el cálculo por Peso y Peso Volumétrico<br />
Calculadora de Envío en página de Producto<br />
Selector y buscador de sucursal<br />
Particionamiento de órden en varios paquetes</p>
<h3>Instalación y Configuración</h3>
<p><iframe loading="lazy" title="CoolCA Instalación + Configuración" src="https://player.vimeo.com/video/883785627?dnt=1&app_id=122963" width="750" height="422" frameborder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write"></iframe></p>
<h3>Funcionamiento</h3>
<p><iframe loading="lazy" title="CoolCA - Funcionamiento" src="https://player.vimeo.com/video/883789516?dnt=1&app_id=122963" width="750" height="422" frameborder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write"></iframe></p>
<h3>Exportación a Correo Argentino</h3>
<p><iframe loading="lazy" title="CoolCA - Exportación al Correo" src="https://player.vimeo.com/video/883791698?dnt=1&app_id=122963" width="750" height="422" frameborder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write"></iframe></p>
<h3>API KEY</h3>
<p>¿Dónde consigo mi API Key?<br />
Debes ingresar a la siguiente dirección <a href="https://coolcaweb.manca.com.ar" rel="nofollow ugc">https://coolcaweb.manca.com.ar</a>.</p>
<h3>Tarifario de precios</h3>
<p>Correo Argentino ya no comparte el tarifario de precios públicamente, pero pueden comunicarse y solicitarlo.</p>


Cool Correo Argentino – WooCommerce

Método de Envío de WooCommerce para Correo Argentino.

Kitgenix Order Tracking for WooCommerce vs Cool Correo Argentino – WooCommerce