Soroban Delivery Dates for WooCommerce

Описание

Show customers an estimated delivery date range that is actually calculated from how your store works — not a flat «+5 days».

Who this is for

If you sell into the UK or Japan, a flat «+5 days» estimate quietly goes wrong: it lands on bank holidays, substitute days and your own closed days, and shows shoppers a date you cannot meet. This plugin works the range out from your actual pattern — open weekdays, preparation time, carrier transit days and the official holiday calendar — and displays it on the product page before checkout, stated as an estimate, never a promise.

How it works

• You choose a holiday calendar: UK bank holidays (official GOV.UK data, per division — England & Wales, Scotland, or Northern Ireland) or Japanese national holidays (generated from the statutory rules).
• You set your store’s open weekdays, any extra custom closed dates, an order cut-off time, a preparation time in business days, and a transit range in carrier days.
• On each product page the plugin counts forward from the moment of viewing: orders before the cut-off start preparation the same business day; later orders start on the next business day. Preparation and transit skip closed days, weekends and holidays on the correct calendar.
• The calculation runs in the visitor’s browser at view time (in your site’s timezone), so the dates stay correct even behind full-page caches and CDNs — including right after the cut-off and across daylight-saving changes. Without JavaScript no dates are shown, rather than risk showing a wrong one.
• The result is displayed as a range with its basis («Based on UK bank holidays (England & Wales). Estimate — not a guarantee.»), plus a live «order within X hrs Y mins» countdown when the cut-off is still ahead.

Built-in safety

• If a calculation would run past the end of the bundled calendar data, the estimate is hidden entirely and the failure is flagged in wp-admin, instead of showing a date the data cannot support.
• A simulator (Tools → Delivery Date Simulator) runs the exact storefront calculation — for any order moment, product and (with Pro) destination — and shows the dispatch date, the range, the effective values used, and the day-by-day walk with reasons, including holiday names.
• A status panel on the settings page shows the calendar coverage with advance warnings before the data runs out, and settings can be exported/imported as JSON.
• The plugin makes no external calls, stores no personal data, and does not read or write orders. All computation happens locally with the bundled calendar data.

Calendars included

• United Kingdom: official bank holidays from GOV.UK (https://www.gov.uk/bank-holidays.json), 2025–2028, for England & Wales, Scotland and Northern Ireland — including substitute days.
• Japan: national holidays 2025–2028 generated from the rules of the Act on National Holidays, including substitute holidays (振替休日) and citizens’ holidays (国民の休日).

A Pro add-on (sold separately, outside wordpress.org) adds per-product and per-category preparation times, per-shipping-zone transit adjustments, a Royal Mail carrier-holiday layer for the UK, a customer-facing calculation breakdown, and display customisation.