Title: WXP Opening Times Author: Wilko van der Ploeg Published: October 25, 2026 Last modified: October 25, 2026 --- Search plugins ![](https://ps.w.org/wxp-opening-times/assets/banner-772x250.png?rev=3764623) ![](https://ps.w.org/wxp-opening-times/assets/icon-256x256.png?rev=3764623) # WXP Opening Times By [Wilko van der Ploeg](https://profiles.wordpress.org/wvdploeg/) [Download](https://downloads.wordpress.org/plugin/wxp-opening-times.1.0.0.zip) * [Details](https://wordpress.org/plugins/wxp-opening-times/#description) * [Reviews](https://wordpress.org/plugins/wxp-opening-times/#reviews) * [Installation](https://wordpress.org/plugins/wxp-opening-times/#installation) * [Development](https://wordpress.org/plugins/wxp-opening-times/#developers) [Support](https://wordpress.org/support/plugin/wxp-opening-times/) ## Description 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. ### Source code and third-party libraries The admin app and the block are built with `@wordpress/scripts`. The readable sources are in the plugin, in `assets/admin/src` and `assets/block/src`; the build commands are in `package.json` (`npm install`, then `npm run build`). The plugin bundles [Twig](https://twig.symfony.com/) (BSD 3-Clause) and a few Symfony polyfills (MIT) in `vendor-prefixed`, with their namespaces prefixed so they cannot clash with other plugins. They are installed with Composer (`composer install`). ## Screenshots [⌊The weekly opening times, with a second set of times for a lunch break, and the alternative texts.⌉⌊The weekly opening times, with a second set of times for a lunch break, and the alternative texts.⌉[ The weekly opening times, with a second set of times for a lunch break, and the alternative texts. [⌊Exceptions: a period with different times (such as winter hours) and a holiday rule, with a live preview.⌉⌊Exceptions: a period with different times (such as winter hours) and a holiday rule, with a live preview.⌉[ Exceptions: a period with different times (such as winter hours) and a holiday rule, with a live preview. ## Blocks This plugin provides 1 block. * Opening times Shows the opening times of a schedule and whether it is open right now. ## Installation 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. ## FAQ ### Why does “open now” use the site’s time zone? Opening times belong to a place, not to the visitor. Set the right time zone under Settings, General. ### Does it work with a page cache? Yes. The status is refreshed in the browser when the page was cached for more than five minutes, and at the moment the status changes. ### Which holidays are included? Secular and Christian holidays, with the Christian ones calculated from Easter. Islamic and Jewish holidays come with the add-on WXP Opening Times: Jewish and Islamic holidays. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “WXP Opening Times” is open source software. The following people have contributed to this plugin. Contributors * [ Wilko van der Ploeg ](https://profiles.wordpress.org/wvdploeg/) “WXP Opening Times” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/wxp-opening-times/contributors) for their contributions. [Translate “WXP Opening Times” into your language.](https://translate.wordpress.org/projects/wp-plugins/wxp-opening-times) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/wxp-opening-times/), check out the [SVN repository](https://plugins.svn.wordpress.org/wxp-opening-times/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wxp-opening-times/) by [RSS](https://plugins.trac.wordpress.org/log/wxp-opening-times/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 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. ## Meta * Version **1.0.0** * Last updated **1 day ago** * Active installations **Fewer than 10** * WordPress version ** 6.5 or higher ** * Tested up to **7.1.3** * PHP version ** 8.1 or higher ** * Languages * [Dutch](https://nl.wordpress.org/plugins/wxp-opening-times/) and [English (US)](https://wordpress.org/plugins/wxp-opening-times/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/wxp-opening-times) * Tags * [business hours](https://wordpress.org/plugins/tags/business-hours/)[holidays](https://wordpress.org/plugins/tags/holidays/) [open now](https://wordpress.org/plugins/tags/open-now/)[Opening Hours](https://wordpress.org/plugins/tags/opening-hours/) [opening times](https://wordpress.org/plugins/tags/opening-times/) * [Advanced View](https://wordpress.org/plugins/wxp-opening-times/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/wxp-opening-times/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/wxp-opening-times/reviews/) ## Contributors * [ Wilko van der Ploeg ](https://profiles.wordpress.org/wvdploeg/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/wxp-opening-times/)