Settings (date math)
The Settings tab is the brain of the plugin — every date the widget shows comes from this tab. Five cards: Shipping, Delivery, Holidays, Date, Cutoff time.
Shipping
Section titled “Shipping”The shipping window is “when the parcel leaves the warehouse”.
| Field | Purpose |
|---|---|
Working days rule (shippingWorkingDaysRuleId) | A Shopware Rule that matches every day that counts as a working day for shipping. Days that don’t match are skipped when counting min/max days. |
Minimum days (shippingMinDays) | Earliest shipping day relative to “today” |
Maximum days (shippingMaxDays) | Latest shipping day relative to “today” |
Both values count working days (after subtracting non-working days and holidays). A pair of 0 / 1 means “ships today or tomorrow”.
Delivery
Section titled “Delivery”The delivery window is “when the parcel arrives at the customer” — counted from the shipping date, not today.
| Field | Purpose |
|---|---|
Working days rule (deliveryWorkingDaysRuleId) | Working days for the courier (can differ from your warehouse — couriers often work Saturdays) |
Minimum days (deliveryMinDays) | Earliest delivery day relative to shipping date |
Maximum days (deliveryMaxDays) | Latest delivery day relative to shipping date |
Use product delivery time if available (useProductDeliveryTime) | If a Shopware product has its own delivery time set, take it into account when computing the delivery window |
The two rule selectors look the same but they belong to different stages of the pipeline — your warehouse can be Mon–Fri while the courier delivers Mon–Sat without conflict.
Working with useProductDeliveryTime
Section titled “Working with useProductDeliveryTime”Shopware ships with a Delivery time entity (singular / plural names, minimum days, maximum days). When this option is on, the plugin reads the product’s deliveryTime field and uses it instead of the Delivery card’s min/max days. The plugin still uses the working-days and holidays rules from this tab to skip non-working days.
For a deeper walkthrough see Advanced → Product delivery time.
Holidays
Section titled “Holidays”| Field | Purpose |
|---|---|
Holidays rule (holidaysRuleId) | A Shopware Rule that matches calendar dates that should be skipped from both the shipping and the delivery window |
Holidays are evaluated before the working-day rule — even if a holiday falls on a Monday, the plugin still treats it as a non-working day.
A typical setup is one rule per country (your shipping origin) with a list of fixed-date conditions for each public holiday. The rule must match by date, not by day of week — usually a series of date-range conditions glued with OR.
| Field | Purpose |
|---|---|
Date format (dateFormat) | Pick from a long list of PHP-style format strings (d/m, D, jS M, l, j F, …). Each option in the drop-down shows an example so you can see what it produces. |
Custom date format (customDateFormat) | Free-form override. Leave empty to use the format above. |
The selected format is used for the %shippingMinDate%, %shippingMaxDate%, %deliveryMinDate%, %deliveryMaxDate% placeholders.
Day, month and weekday names used in those formats come from the Translation tab — see Configuration → Translations for how to localise them.
Cutoff time
Section titled “Cutoff time”The cutoff time tells the plugin when an order placed today still counts as today’s order vs. tomorrow’s.
| Field | Purpose |
|---|---|
Time format (cutoffTimeFormat) | How %cutoffTime% is formatted: hours+minutes+seconds, or hours+minutes only |
| Bold numbers / Bold texts | Visual emphasis inside the formatted time |
General cutoff time (cutoffTime) | The default cutoff for any day |
| Monday cutoff time … Sunday cutoff time | Per-weekday overrides. Leave empty to inherit the general cutoff. |
The two time format options are:
%hours% %transHours% %minutes% %transMinutes% %seconds% %transSeconds%%hours% %transHours% %minutes% %transMinutes%The plain-text labels (%transHours%, %transMinutes%, %transSeconds%) are pulled from the global widget snippets (hour / hours, minute / minutes, second / seconds) on the Translation tab — so they pluralise correctly and localise per language.
Per-weekday cutoffs
Section titled “Per-weekday cutoffs”A common pattern:
- Mon–Thu:
15:00(general cutoff) - Friday:
13:00(courier picks up earlier) - Saturday/Sunday: empty (no shipping)
Leaving Saturday and Sunday empty means “nothing ships those days”. Combined with a working-days rule that doesn’t include weekends, an order placed on Saturday is automatically rolled over to Monday.