Kind of Lost Route Optimizer for WooCommerce

By Kind of Lost

0+ active installationsVersion 1.0.0

Turn your WooCommerce orders into optimized multi-vehicle delivery routes, with Google Maps links, driver pages and CSV export. Admin only.

Description

Pick the orders you need to deliver (by status and date range), say how many vehicles you have and how many orders each can carry, and get one route per vehicle: the stop order, estimated arrival times, a Google Maps directions link and a mobile driver page with tap-to-navigate for every stop. Download the plan as CSV.

  • Admin page under WooCommerce > Delivery Routes. Nothing is added to your storefront.
  • Select orders by status (default: Processing) and date range (order created date, or a delivery date stored in an order meta field by another plugin).
  • Depot address, number of vehicles, capacity per vehicle (in orders) and departure time.
  • Routes shown as tables: stop order, arrival time, order link, customer, address, phone.
  • Google Maps directions link and driver page link per route.
  • CSV export.
  • HPOS (custom order tables) compatible. Uses WooCommerce CRUD functions only.
  • Requires manage_woocommerce capability.

Route planning is done by a heuristic solver (Google OR-Tools guided local search) on real road driving times from OpenStreetMap. Routes are the best found in the time allowed: good, but not proven optimal. Times are estimates and do not use live traffic.

Limits (set by the free routing service): up to 49 orders per run (the depot address is one of the 50 address lookups allowed per request), up to 25 vehicles, one depot, one trip per vehicle, and roughly 20 planning runs per 10 minutes per website IP address. All orders carry equal weight; capacity is counted in orders.

WooCommerce has no built-in delivery date. If you use a delivery date or time slot plugin that stores the date in an order meta field, enter that field name in Settings. Time windows per order are not supported in this version.

External services

This plugin sends data to a third-party service to compute routes. It does nothing until an administrator clicks “Plan routes”.

Service: Kind of Lost route optimizer, https://routing.kindoflost.com (operated by the plugin author), endpoint https://routing.kindoflost.com/mcp (Model Context Protocol, JSON-RPC 2.0 over HTTPS).

When: each time an administrator clicks “Plan routes” (one request), and when clicking “Check again” if a plan takes longer than 45 seconds (one more request).

What is sent: the depot address from the plugin settings; for each selected order, an identifier made of the order number (for example “#1234”), the delivery address (shipping address, or billing address if there is no shipping address: street, city, state, postcode, country) and a quantity of 1; the number of vehicles and their capacity; the departure time; the address lookup mode (US or other); and a short search-time setting. Customer names, phone numbers, email addresses and order contents are not sent.

What the service does with it: it converts the addresses to coordinates using public geocoders (the US Census Geocoder, OpenStreetMap Nominatim and, as a fallback, Photon by komoot) and requests driving times from a public OpenStreetMap routing server, so the addresses, or coordinates derived from them, are passed on to those services. See the privacy policy for details and retention.

Links: Terms: none beyond the privacy policy. Privacy policy: https://routing.kindoflost.com/privacy

The routes the service returns are kept by this plugin for one hour (as a WordPress transient per user, to allow the CSV download) and are removed when the plugin is uninstalled.

The Google Maps directions links in the results are plain links that open google.com/maps in your browser when you click them. The plugin does not contact Google.

Installation

  1. Install and activate the plugin (WooCommerce must be active).
  2. Go to WooCommerce > Delivery Routes > Settings and enter your depot address.
  3. Go to WooCommerce > Delivery Routes, choose statuses, dates, vehicles and capacity, and click “Plan routes”.

FAQ

Is it really free?

The plugin is free and GPL licensed. The routing service it calls is also free to use, with the limits listed in the description. The service is run by the plugin author and may change its limits.

Do my customers see anything?

No. The plugin adds nothing to the storefront, checkout or emails.

Why are some orders skipped?

Orders without a street address and a city or postcode are skipped and listed under the results.

Why is an order “not assigned to any vehicle”?

Either the vehicles do not have enough combined capacity, or an address could not be located. Raise capacity or add a vehicle, or correct the address.

Can I plan more than 49 orders?

Not in one run. Split by date range or order status. You can also use the web tool at https://routing.kindoflost.com, which has no stop cap.

Does it support time windows or order weights?

Not in this version. Every order counts as one stop and one unit of capacity.

Changelog

1.0.0

  • Initial release.