Linux 软件免费装
Banner图

Soroban Delivery Dates for WooCommerce

开发者 sorobandataworks
更新时间 2026年11月18日 20:24
PHP版本: 8.0 及以上
WordPress版本: 7.1
版权: GPLv2 or later
版权网址: 版权信息

标签

woocommerce delivery date estimated delivery business days bank holidays

下载

1.1.2 1.1.3

详情介绍:

Ever seen a product page promise a delivery date that the cut-off had already passed? Full-page caches and CDNs freeze whatever date was calculated when the page was cached. This plugin calculates the estimate in the visitor's browser, at the moment the page is viewed, so it stays correct behind page caches and CDNs — including right after your cut-off and across daylight-saving changes. It counts forward from how your store really works: open weekdays, order cut-off, preparation time, carrier transit days and the official holiday calendar (UK bank holidays from GOV.UK, by division, or Japanese national holidays). The result is shown as an estimated range with its basis — never as a guarantee. 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 Built-in safety Calendars included How the dates are checked The UK calendar is a bundled snapshot of the official GOV.UK bank-holiday data — not a hand-typed list — and the Japanese calendar is generated from the rules laid down in the Act on National Holidays, including substitute holidays and citizens' holidays. The server-side and browser-side calculations are verified against each other across 18 test scenarios, covering daylight-saving weekends, cut-off boundaries in British Summer Time and division-specific holiday exceptions. If a calculated date would fall outside the bundled calendar data (2025–2028), the estimate is hidden rather than guessed. Every estimate is labelled as an estimate, with its calendar basis shown — never as a guaranteed delivery date. 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.

安装:

  1. Upload the soroban-delivery-dates folder to /wp-content/plugins/, or install the zip via Plugins → Add New → Upload.
  2. Activate the plugin.
  3. Go to WooCommerce → Delivery Dates and choose your calendar, open days, cut-off time, preparation and transit times.
  4. Check a scenario under Tools → Delivery Date Simulator.
  5. The estimate appears on single product pages automatically (cart and checkout pages are not covered yet — see FAQ). You can also place it anywhere with the [soroban_delivery_estimate] shortcode.

屏幕截图:

  • Settings under WooCommerce → Delivery Dates.
  • The simulator's day-by-day walk with holiday names.
  • The same product page with the Japanese national-holiday calendar.
  • The estimate placed on a regular page with the [soroban_delivery_estimate] shortcode.

升级注意事项:

1.1.3 Fixes the delivery estimate not appearing on sites that use the "Plain" permalink setting. 1.1.2 Renamed to Soroban Delivery Dates (new slug: soroban-delivery-dates), plus output-sanitisation and REST endpoint hardening. 1.1.1 Maintenance release: compatibility re-verification; the minimum PHP version is now 8.0. 1.1.0 Recommended update: fixes stale estimates behind page caches, a Shop Manager save failure, and a fail-safe notice that never cleared.

常见问题:

Are the dates a guarantee?

No. The plugin always presents dates as an estimated range with its basis stated, and never as a guaranteed delivery date. Weather, carrier delays and other factors outside the calculation can still change the actual arrival day.

Does the estimate show on the cart and checkout pages?

Not yet. The estimate is shown on single product pages (and anywhere you place the [soroban_delivery_estimate] shortcode). Cart and checkout pages show WooCommerce's own shipping-method display, so the two can disagree — for example, a product page saying "Thursday" while checkout says "Friday". Cart and checkout display using the same calculation is the next feature; the cart version needs a "latest item in the cart" rule first, because a multi-item cart has no single product estimate to show. No date is promised for it yet.

Which calendars are supported?

UK bank holidays by division (England & Wales, Scotland, Northern Ireland), from official GOV.UK data, and Japanese national holidays generated from the statutory rules. Each store uses one calendar.

What happens when the calendar data runs out?

The bundled data covers 2025–2028. If a calculation would need dates beyond the coverage, the estimate is hidden and an admin notice records the fail-safe event. Update the plugin to receive newer calendar data.

Does the plugin phone home or track customers?

No. There are no requests to third-party services and no analytics. The only data stored is your settings and the fail-safe state record (reason and timestamps only). The per-product calculation inputs endpoint answers using the visitor's own WooCommerce session (for shipping-zone rules) and stores nothing.

Does it work with page caching or a CDN?

Yes. Product pages contain no pre-calculated dates; the estimate is computed in the visitor's browser when the page is viewed, using a cacheable configuration document whose URL changes whenever settings change. Per-visitor inputs are fetched with a private, no-store request.

Why does my delivery date show yesterday's date, or ignore my cut-off?

If the product page is cached, a date calculated on the server is frozen at cache time. This plugin never stores a pre-calculated date in the page; the estimate is computed in the browser when the page is viewed.

Does it need JavaScript?

On the storefront, yes: dates are calculated in the browser so they are correct at the moment of viewing. Without JavaScript, no dates are displayed (a short neutral note appears instead). wp-admin (settings preview and simulator) works without JavaScript.

Who can change the settings?

Anyone with the WooCommerce shop-management capability (Administrators and Shop Managers). Viewing and saving use the same capability.

Can I set different preparation times per product?

Not in the free version — one store-wide preparation time. Per-product and per-category preparation times are part of the Pro add-on.

Does it work with HPOS (custom order tables)?

Yes. The plugin declares HPOS compatibility, and it does not read or write order data at all.

更新日志:

1.1.3 1.1.2 1.1.1 1.1.0 1.0.0