DoubleShore Opening Hours

A custom Umbraco property editor for managing weekly business opening hours, with support for two shifts per day (e.g. a morning and an afternoon block separated by a lunch break).

Features

• Edit opening and closing times for each day of the week (Monday through Sunday).
• Optional lunch break per day (open2 = lunch start, close2 = lunch end) for split working hours.
• Per-day "scheduled" toggle to mark a day as open or closed.
• Holiday / special dates — override the hours for a specific date or mark it closed (e.g. public holidays), with an optional note.
• Value stored as JSON and exposed to views through a strongly-typed property value converter (OpeningHoursSchedule: Days + Exceptions), including a culture-aware abbreviated day name (e.g. "Mon" in en-US, "seg." in pt-PT).
• "Open now / next open" helper — schedule.GetStatus() / schedule.IsOpenNow() (in DoubleShore.Kit.OpeningHours.Extensions) compute whether the business is open right now and when it next opens, honouring lunch breaks and holiday exceptions.
• schema.org JSON-LD — OpeningHoursSchema.BuildOpeningHoursSpecification(schedule) (in DoubleShore.Kit.OpeningHours.Schema) emits OpeningHoursSpecification entries, including date-scoped validFrom/validThrough for special dates.
• 12-hour / 24-hour display — a data-type setting ("12-hour clock (AM/PM)") controls how times render on the website (e.g. 1:00 PM vs 13:00). Times are always entered and stored in 24-hour HH:mm; use schedule.FormatTime(value) to render with the chosen format. Exposed on OpeningHoursSchedule.TwelveHour.

Data-type setup

Create the data type with the Opening Hours property editor (schema DoubleShore.OpeningHours). The "12-hour clock" setting only appears when the data type uses this schema — a data type built on the generic Umbraco.Plain.String schema with this UI will store/read values fine but won't surface the setting.

Value shape

The stored value is a JSON object: { "days": [ …7 days… ], "exceptions": [ … ] }. The legacy bare-array shape ([ …7 days… ]) is still read transparently, so existing content keeps working.

Requirements

• Umbraco 17
• .NET 10

Installation

dotnet add package DoubleShore.Kit.OpeningHours

The property editor and its backoffice UI register automatically once the package is installed — no manual configuration is required.

Usage

1. In the Umbraco backoffice, go to Settings → Data Types and create a new data type.
2. Choose DoubleShore Opening Hours as the property editor.
3. Save the data type, then add it as a property on any document type.
4. Editors can then set per-day opening/closing times (and an optional second shift) on content using that document type.

The saved value is available on your published models via the package's property value converter as a typed schedule you can render in your views.

License

MIT