Phone and opening hours

phoneCopy Anchor Link

A telephone number, parsed and checked for its region and stored in international E.164 form beside what the editor typed. Held once for every locale.

fields:
  - { name: phone, type: phone, index: true }
  - { name: mobile, type: phone, region: GB, types: [mobile] }

Stored value:

{ "raw": "01295 123456", "region": "GB", "e164": "+441295123456", "national": "01295 123456", "type": "fixed_line" }

raw and region are what the editor typed and where; the rest is derived on save. In a seed file or import, { raw, region } is enough, and a bare string is read in the field’s region parameter (without one it must start with +). With index: true the E.164 form is projected.

Template value:

{% if entry.phone %}<a href="{{ entry.phone.telHref|url }}">{{ entry.phone.display }}</a>{% endif %}

opening_hoursCopy Anchor Link

When a place is open: a regular week, seasons that replace it between two dates each year, exceptions for single days, behaviour on public holidays, a note per locale and a by-appointment flag. The structure is held once for every locale; only the notes are per locale, inside the value.

fields:
  - name: openingHours
    type: opening_hours
    holiday_calendar: uk-england-wales
    timezone: Europe/London
    max_periods: 2

The editor takes one row per weekday with a closed switch and the periods as shorthand (12:00-15:00, 18:00-23:00; a close at or before the open runs into the next day), seasons and exceptions as rows, the holiday calendar and behaviour, and this locale’s note.

Stored value:

{
  "timezone": "Europe/London",
  "regular": [
    { "day": "mon", "periods": [{ "open": "09:30", "close": "16:30" }] },
    { "day": "sun", "closed": true }
  ],
  "seasons": [
    { "from": "11-01", "to": "02-28", "regular": [{ "day": "sat", "periods": [{ "open": "10:00", "close": "14:00" }] }] }
  ],
  "exceptions": [
    { "date": "2026-12-24", "periods": [{ "open": "09:30", "close": "12:00" }], "note": "Christmas Eve" }
  ],
  "holiday_calendar": "uk-england-wales",
  "holiday_behaviour": "closed",
  "notes": { "en-GB": "Tours at 11:00 and 14:00; booking essential." },
  "by_appointment": false
}

On save the value is normalised (Monday first, empty days dropped, exceptions sorted by date), so two edits that mean the same store the same bytes. Each problem is reported at its path with code opening_hours: timezone: a time zone is required, seasons[0].from: must be MM-DD, exceptions[1]: closed and periods cannot both be set, regular[2].day: mon appears twice, holiday_behaviour: must be closed, normal or hours, holiday_calendar: unknown holiday calendar.

With index: true the field projects one boolean, whether any hours are set, which is what a “places with no opening hours” list reads.

Template value. Methods take a time; pass the now global for the current moment.

{% set hours = entry.openingHours %}
{% if hours and not hours.isEmpty %}
<p>{% if hours.isOpenAt(now) %}{{ t('hours.open_now') }}{% else %}{{ t('hours.closed_now') }}{% endif %}</p>
<table>
  <caption>{{ t('hours.caption') }}</caption>
  <thead><tr><th scope="col">{{ t('hours.day') }}</th><th scope="col">{{ t('hours.times') }}</th></tr></thead>
  <tbody>
    {% for day in hours.week(now) %}
    <tr{% if day.isToday %} aria-current="date"{% endif %}><th scope="row">{{ day.label }}</th><td>{{ day.periodsLabel }}</td></tr>
    {% endfor %}
  </tbody>
</table>
{% if hours.note %}<p>{{ hours.note }}</p>{% endif %}
{% endif %}