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.<\/p>\n\n
[wxp_opening_times]\n<\/code><\/pre>\n\nAttributes:<\/p>\n\n
\nschedule<\/code> - id of the schedule, shown in the admin (default: the first schedule).<\/li>\ntemplate<\/code> - default<\/code> (week table) or compact<\/code> (one line), or a template from your theme.<\/li>\nshow_status<\/code> - yes<\/code> or no<\/code>: the Open\/Closed badge (default yes).<\/li>\nshow_title<\/code> - yes<\/code> or no<\/code>: the schedule name as a heading (default no); heading_level<\/code> sets the level (2-6, default 3).<\/li>\nshow_dates<\/code> - yes<\/code> or no<\/code>: the date next to each weekday (default no).<\/li>\nweek_nav<\/code> - yes<\/code> or no<\/code>: previous\/next week buttons (default no); weeks_ahead<\/code> sets how far visitors can look ahead (0-26, default 4).<\/p><\/li>\ntext_closed<\/code>, text_open<\/code>, text_separator<\/code>, text_open_until<\/code>, text_closed_opens<\/code> - other words for this block only, for example text_closed=\"Absent\"<\/code>. They win over the texts set for the schedule in the admin. Use {time}<\/code> in the last two for the time.<\/p><\/li>\n<\/ul>\n\nElementor<\/h4>\n\n
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.<\/p>\n\n
Block editor<\/h4>\n\n
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.<\/p>\n\n
Structured data (JSON-LD)<\/h4>\n\n
Add schema=\"yes\"<\/code> 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<\/code>), 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<\/code> 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<\/code> filter, for example to make it a Restaurant<\/code>.<\/p>\n\nIf an SEO plugin already prints the data of your business, use wxp_opening_times_get_schema()<\/code> to get the same array, and add it there.<\/p>\n\nFor developers<\/h4>\n\n
Template override: copy a file from the plugin's templates<\/code> folder to wxp-opening-times\/<\/code> in your (child) theme. The markup contract is described at the top of _base.html.twig<\/code>.<\/p>\n\nHelper functions (call them after the init<\/code> action):<\/p>\n\n\nwxp_opening_times_is_open( $schedule = '', $at = null )<\/code> returns true when open. $at<\/code> is an optional DateTimeImmutable.<\/li>\nwxp_opening_times_get_holidays( $date )<\/code> returns the holidays on a date (Y-m-d<\/code>) as a list of key<\/code>, label<\/code> and calendar<\/code>.<\/li>\nwxp_opening_times_get_schedules()<\/code> returns configured<\/code> (whether anything was saved yet) and the schedules<\/code> (id<\/code> and name<\/code>).<\/li>\nwxp_opening_times_get_status( $schedule = '', $at = null )<\/code> returns open<\/code>, closes_at<\/code>, opens_at<\/code>, next_change<\/code> (Unix times) and schedule<\/code>, or null for an unknown schedule.<\/li>\n<\/ul>\n\nFilters: wxp_opening_times_status<\/code>, wxp_opening_times_template_context<\/code>, wxp_opening_times_template_paths<\/code>, wxp_opening_times_twig_cache<\/code>, wxp_opening_times_schema<\/code>, wxp_opening_times_schema_days<\/code>, wxp_opening_times_load_css<\/code> (return false to load your own CSS) and wxp_opening_times_holidays<\/code> (add holiday providers, for example for other calendars).<\/p>\n\n