About this plugin
” badge and JSON-LD structured data for search engines.
What this plugin does
- Define weekly opening hours (Mon–Sun) with multiple time windows per day.
- Add special days (e.g. public holidays, one-off openings/closings).
- Add vacation periods with custom hours or “closed all day”.
- Show a “Now open / Now closed” badge with human-readable “next change” text.
- Output JSON-LD (Schema.org) for openingHoursSpecification and special opening hours to help search engines display correct business hours.
- Render via:
- Gutenberg block “Opening Hours”
- Classic widget “Opening Hours”
- Shortcodes for hours, badge and special days.
Free version: one global location (one set of hours) per site.
A Pro add-on for multiple locations and extended features is planned, but the free plugin is fully usable on its own.
Key features
- Single global location (Free) – one central timetable for your business.
- Weekly opening hours
- Multiple time windows per day (e.g. 09:00–12:00 and 13:30–18:00).
- Mark days as closed.
- Special days / holidays
- Override normal hours for specific calendar days.
- Mark as closed or set custom hours.
- Vacation periods
- Configure longer ranges (e.g. company vacation).
- Closed or limited hours during the range.
- Display options
- Show/hide “Now open?” badge.
- Show/hide “Next change” text (“closes in 2 hours”, …).
- Show/hide closed days in the weekly grid.
- Choose time and date formats (PHP date/time format).
- Views
- Grid view – full weekly overview.
- Today view – only show today’s opening hours.
- Compact view – badge + short line of text (for tight spaces, sidebars, footers).
- Structured data
- Outputs Schema.org JSON-LD for LocalBusiness with weekly and special opening hours.
- Uses your site title and home URL by default.
- Editor integrations
- Gutenberg block with inspector controls for view, badge, “next change”, JSON-LD and optional CTA link.
- Classic widget for legacy themes.
- Translations
- Ships with initial translations: de_DE, de_CH, fr_FR, it_IT, es_ES, nl_NL, da_DK, fi, sv_SE, nb_NO, cs_CZ, pl_PL, pt_PT, ru_RU, ja, zh_CN.
- Fully ready for translate.wordpress.org.
Shortcodes
All shortcodes automatically use the global settings from Settings → Opening Hours.
Main output (grid view)
[bkohh_opening_hours]
Renders the weekly grid with your current settings.
Optional attributes:
- timezone – override configured timezone (e.g. timezone="Europe/Zurich" ).
- format_time – override time format ( H:i, g:i A, …).
- format_date – override date format for any dates that are shown.
- jsonld – 1 (default) to append JSON-LD, 0 to disable.
“Now open?” badge
[bkohh_open_badge]
Outputs a compact block with:
- Badge: “Now open” / “Now closed”.
- Optional “next change” text (e.g. “closes in 45 min”).
- Optional CTA link (label + URL) configured via shortcode or block/widget.
Respects the timezone, formats and display options from the settings.
Upcoming special days
[bkohh_special_days]
Shows a small list of upcoming special days/holidays.
Useful attributes:
- limit – maximum number of items to show (default: 5 ).
- empty_text – text to display if there are no upcoming special days.
- timezone, format_date, format_time – overrides for date/time output.
Grouped weekly hours
[bkohh_grouped_hours]
g. “Mon–Fri 09:00–18:00, Sat 10:00–14:00”).
Respects the global display settings (badge, next change, closed days).