Snippet variables
The widget’s snippet fields (message text, tooltip text, clock labels, step titles and dates) support a set of placeholders that are substituted at render time. They all use the %name% syntax.
Date placeholders
Section titled “Date placeholders”| Placeholder | Value |
|---|---|
%todayDate% | Today’s date, formatted according to the Date format on the Settings tab. |
%shippingMinDate% | Earliest shipping date. |
%shippingMaxDate% | Latest shipping date. |
%shippingMinDateName% | Earliest shipping date written as a name — short weekday (Mon), today or tomorrow when applicable. |
%shippingMaxDateName% | Same, for the max shipping date. |
%deliveryMinDate% | Earliest delivery date. |
%deliveryMaxDate% | Latest delivery date. |
%deliveryMinDateName% | Earliest delivery date as a weekday name / “today” / “tomorrow”. |
%deliveryMaxDateName% | Same, for the max delivery date. |
The date format used for the *Date variants comes from Settings → Date → Date format. The “name” variants are localised through the Translation tab’s weekday and “today / tomorrow” snippets.
Cutoff and countdown placeholders
Section titled “Cutoff and countdown placeholders”| Placeholder | Value |
|---|---|
%cutoffTime% | Formatted countdown to the cutoff time, using cutoffTimeFormat (see below). |
%hours% | Hours remaining until the cutoff. |
%minutes% | Minutes remaining. |
%seconds% | Seconds remaining. |
%days% | Days remaining (only if the next cutoff is more than 24 hours away). |
%transHours% | Localised “hour” / “hours” label (auto-pluralised). |
%transMinutes% | Localised “minute” / “minutes” label. |
%transSeconds% | Localised “second” / “seconds” label. |
%transDays% | Localised “day” / “days” label. |
%xDays% | Used inside the for_x_days translation as the numeric value. |
Weekday name placeholders (long and short)
Section titled “Weekday name placeholders (long and short)”Long: %monday%, %tuesday%, %wednesday%, %thursday%, %friday%, %saturday%, %sunday%.
Short: %mon%, %tue%, %wed%, %thu%, %fri%, %sat%, %sun%.
Each one resolves to the value from the corresponding Translation snippet.
Month name placeholders
Section titled “Month name placeholders”%january%, %february%, %march%, %april%, %may%, %june%, %july%, %august%, %september%, %october%, %november%, %december%.
PHP date-format letters
Section titled “PHP date-format letters”If you put a single PHP date-format letter into a snippet, the plugin substitutes it with the formatted value of today’s date. Supported letters:
| Letter | Output |
|---|---|
%d% | Day of the month, 2 digits (02) |
%j% | Day of the month, no leading zero (2) |
%m% | Month number, 2 digits (09) |
%n% | Month number, no leading zero (9) |
%y% | Year, 2 digits (24) |
%Y% | Year, 4 digits (2024) |
%D% | Short weekday name (Wed) |
%l% | Long weekday name (Wednesday) |
%M% | Short month name (Sep) |
%F% | Long month name (September) |
%S% | Day-of-month suffix (st, nd, rd, th) |
These work as quick inline date pieces — for example a step title that reads "%l% %j%" would render as "Wednesday 2".
Other placeholders
Section titled “Other placeholders”| Placeholder | Value |
|---|---|
%tooltip% | The tooltip icon, rendered with the styling from the Widget → Tooltip card. Hovering it reveals the Tooltip text. |
Reading the defaults
Section titled “Reading the defaults”The most useful defaults to start from:
- Message text —
<strong>🕖Cut-Off Time:</strong> %cutoffTime%, ships %shippingMinDateName% %tooltip% - Clock dispatch date —
%shippingMinDate% - Step 1 date —
%todayDate% - Step 2 date —
%shippingMinDate% - Step 3 date —
%deliveryMinDate% - %deliveryMaxDate% for_x_dayssnippet —for %xDays% days
A note on HTML inside snippets
Section titled “A note on HTML inside snippets”The message text accepts arbitrary HTML — you can wrap parts of the message in <strong>, <span class="…"> or any other tag and style them in your theme CSS. The tooltip text is similarly HTML-safe.
Snippets used in clock labels and step titles are rendered as plain text — HTML there will be visible verbatim.