WXP Opening Times

WXP Opening Times shows your opening times on any page with a shortcode, together with an Open/Closed badge that stays correct while the visitor is on the page.

• Set the weekly opening times by ticking the days. Add a second (or third) set of times for a lunch break: 8:00–12:00 and 14:00–18:00. A closing time earlier than the opening time means "after midnight".
• Exceptions: different times in a period (summer and winter hours, a holiday closure, only on certain weekdays), and rules for holidays. Holiday dates are calculated for every year (Easter and everything that depends on it included).
• Several named schedules, for example "Restaurant" and "Kitchen". Each can use its own words, such as "Absent" instead of "Closed" for a doctor, or "to" instead of a dash.
• Visitors can browse to the next weeks.
• Templates are written in Twig and can be overridden in your theme.
• Works on its own. It can be used next to WXP Restaurant Menu, but does not need it.
• Ready for translation: help translate it on translate.wordpress.org.

Shortcode [wxp_opening_times] Attributes:

• schedule - id of the schedule, shown in the admin (default: the first schedule).
• template - default (week table) or compact (one line), or a template from your theme.
• show_status - yes or no: the Open/Closed badge (default yes).
• show_title - yes or no: the schedule name as a heading (default no); heading_level sets the level (2-6, default 3).
• show_dates - yes or no: the date next to each weekday (default no).
• week_nav - yes or no: previous/next week buttons (default no); weeks_ahead sets how far visitors can look ahead (0-26, default 4).
• text_closed, text_open, text_separator, text_open_until, text_closed_opens - other words for this block only, for example text_closed="Absent". They win over the texts set for the schedule in the admin. Use {time} in the last two for the time.

Elementor With Elementor active, the "Opening times" widget (panel "WXP Plugins") shows the same output as the shortcode. It has the same options, optional alternative texts for that widget, and style controls for the badge colours, the typography, the lines, the highlight of today and the week buttons. Block editor The "Opening times" block (category "WXP Plugins") has the same options as the shortcode in the sidebar, including the alternative texts, and shows a live preview in the editor. Like the shortcode and the Elementor widget it is rendered on the server, so the status is always current. Structured data (JSON-LD) Add schema="yes" to the shortcode (or switch on "Structured data for search engines" in the block or the Elementor widget) and the page also gets the opening times as schema.org JSON-LD (openingHoursSpecification), so search engines can show them. The weekly hours are included, and so are the exceptions of the next 365 days: a closed day has opens and closes "00:00". It is printed once per schedule on a page, and not in the editor previews. The business is a LocalBusiness with the site name and address of the home page; change the type or add details (address, phone number) with the wxp_opening_times_schema filter, for example to make it a Restaurant. If an SEO plugin already prints the data of your business, use wxp_opening_times_get_schema() to get the same array, and add it there. For developers Template override: copy a file from the plugin's templates folder to wxp-opening-times/ in your (child) theme. The markup contract is described at the top of _base.html.twig. Helper functions (call them after the init action):

• wxp_opening_times_is_open( $schedule = '', $at = null ) returns true when open. $at is an optional DateTimeImmutable.
• wxp_opening_times_get_holidays( $date ) returns the holidays on a date (Y-m-d) as a list of key, label and calendar.
• wxp_opening_times_get_schedules() returns configured (whether anything was saved yet) and the schedules (id and name).
• wxp_opening_times_get_status( $schedule = '', $at = null ) returns open, closes_at, opens_at, next_change (Unix times) and schedule, or null for an unknown schedule.

Filters: wxp_opening_times_status, wxp_opening_times_template_context, wxp_opening_times_template_paths, wxp_opening_times_twig_cache, wxp_opening_times_schema, wxp_opening_times_schema_days, wxp_opening_times_load_css (return false to load your own CSS) and wxp_opening_times_holidays (add holiday providers, for example for other calendars). CSS custom properties on .wxp-opening-times (--wxp-ot-open-bg, --wxp-ot-closed-bg and more) change the colours.

1. Upload the plugin to /wp-content/plugins/ and activate it.
2. Open "Opening times" in the admin menu and set your times.
3. Add [wxp_opening_times] to a page.

The time zone, the week start day and the time format are taken from Settings, General.

1.0.0

• First stable release. No functional changes since 0.12.0.
• The source of the built JavaScript is now included in the plugin.

0.12.0

• New helper functions wxp_opening_times_get_holidays( $date ) (the holidays on a date) and wxp_opening_times_get_schedules(), used by WXP Local Events to warn about events on holidays and closed days.

0.11.0

• A holiday can now have more than one date in a year (needed for the Islamic calendar), for add-ons.
• A holiday rule for a holiday that is not available (for example when an add-on is deactivated) is kept, shown as "not available" in the admin, and does nothing until the add-on is back.

0.10.0

• Opening times as schema.org JSON-LD (schema="yes", block toggle, Elementor switch), with the filters wxp_opening_times_schema and wxp_opening_times_schema_days and the function wxp_opening_times_get_schema().

0.9.0

• Block for the block editor, with a live preview and the same options as the shortcode.
• Elementor widgets of all WXP plugins now share one panel, "WXP Plugins".
• The compact template no longer repeats the status in a second line.

0.8.0

• Elementor widget with content, text and style controls.
• Alternative texts per block through the text_* shortcode attributes.
• The plugin shows an admin notice instead of a fatal error when it cannot start; the bundled Twig no longer conflicts with other plugins that bundle it.

0.7.0

• Alternative texts per schedule: the words Open and Closed, the separator between opening and closing time, and the two status sentences.
• A rule that is switched from Closed to Open gets a first set of opening times.

0.6.0

• Dutch, German and French translations, helper functions for themes, readme.

0.5.0

• Week navigation for visitors and a status that updates by itself.

0.4.0

• The [wxp_opening_times] shortcode with Twig templates.

0.3.0

• The admin screen.

0.2.0

• Storage and REST routes.

0.1.0

• Opening times logic and holiday calculation.