Title: Bitkit Opening Hours & Holidays Author: bitkit Published: 2025 年 12 月 11 日 Last modified: 2025 年 12 月 11 日 --- 搜索插件 ![](https://ps.w.org/bitkit-opening-hours-holidays/assets/banner-772x250.png?rev =3418097) ![](https://ps.w.org/bitkit-opening-hours-holidays/assets/icon-256x256.gif?rev=3418097) # Bitkit Opening Hours & Holidays 作者：[bitkit](https://profiles.wordpress.org/bitkit/) [下载](https://downloads.wordpress.org/plugin/bitkit-opening-hours-holidays.1.0.1.zip) * [详情](https://cn.wordpress.org/plugins/bitkit-opening-hours-holidays/#description) * [评价](https://cn.wordpress.org/plugins/bitkit-opening-hours-holidays/#reviews) * [安装](https://cn.wordpress.org/plugins/bitkit-opening-hours-holidays/#installation) * [开发进展](https://cn.wordpress.org/plugins/bitkit-opening-hours-holidays/#developers) [支持](https://wordpress.org/support/plugin/bitkit-opening-hours-holidays/) ## 描述 Bitkit Opening Hours + Holidays lets you manage business hours, holidays and vacation periods for a single location and display them via shortcode, Gutenberg block or classic widget – including an optional “Now open?” 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] ``` Groups days with identical hours into ranges (e.g. “Mon–Fri 09:00–18:00, Sat 10: 00–14:00”). Respects the global display settings (badge, next change, closed days). ## 屏幕截图 * [[ * **Settings screen** – Weekly hours, special days and vacation periods with timezone and formatting options. * [[ * **Gutenberg block** – “Opening Hours” block with inspector controls for view, badge, “next change”, JSON-LD and CTA link. * [[ * **Frontend grid view** – Weekly table with “Now open” badge and “next change” text. * [[ * **Grouped view** – Days automatically grouped by identical opening hours. * [[ * [[ ## 安装 1. Upload the plugin folder `opening-hours-holidays` to `/wp-content/plugins/` or install it via the WordPress plugin installer. 2. Activate the plugin through **Plugins Installed Plugins**. 3. Go to **Settings Opening Hours** to configure: 4. * Timezone, time/date formats * Weekly opening hours * Special days / holidays * Vacation periods * Display options (badge, next change, show closed days) 5. Add the output on the frontend using: 6. * The **“Opening Hours”** block in the block editor, or * The classic widget **“Opening Hours”**, or * One of the shortcodes described below. ## 常见问题 ### Does it support multiple locations? The free version is intentionally kept simple and manages one global set of opening hours per site. Support for multiple locations (each with its own timetable, shortcodes and JSON-LD) is planned for a separate Pro add-on. ### What schema.org type is used for JSON-LD? By default the plugin outputs JSON-LD using the `LocalBusiness` type, your site title as the name and the home URL as the `@id`/`url`. The weekly hours and special days are mapped to `openingHoursSpecification` and `specialOpeningHoursSpecification`. ### Will it work with caching plugins? Yes. The “open now” status is calculated in PHP and cached internally for a short time using WordPress transients. When you save new opening hours, the plugin automatically invalidates its own cache. Be aware that very aggressive full-page caching can still delay the visible change between “open” and “closed” if the cached page is not refreshed. ### Can I change the timezone or time format? Yes. You can set the timezone and formats on the settings screen, and some shortcodes also accept optional `timezone`, `format_time` and `format_date` attributes. The plugin uses PHP’s `DateTime` internally. ### Which languages are supported? The plugin is fully translation-ready and ships with several `.po/.mo` files (German, French, Italian, Spanish, Dutch, Danish, Finnish, Swedish, Norwegian (Bokmål), Czech, Polish, Portuguese, Russian, Japanese, Simplified Chinese). Once the plugin is published on wordpress.org, translations will be managed via translate.wordpress. org as well. ## 评价 此插件暂无评价。 ## 贡献者及开发者 「Bitkit Opening Hours & Holidays」是开源软件。 以下人员对此插件做出了贡献。 贡献者 * [ bitkit ](https://profiles.wordpress.org/bitkit/) [帮助将「Bitkit Opening Hours & Holidays」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/bitkit-opening-hours-holidays) ### 对开发感兴趣吗? 您可以[浏览代码](https://plugins.trac.wordpress.org/browser/bitkit-opening-hours-holidays/)， 查看[SVN仓库](https://plugins.svn.wordpress.org/bitkit-opening-hours-holidays/)， 或通过[RSS](https://plugins.trac.wordpress.org/log/bitkit-opening-hours-holidays/?limit=100&mode=stop_on_copy&format=rss) 订阅[开发日志](https://plugins.trac.wordpress.org/log/bitkit-opening-hours-holidays/)。 ## 更新日志 #### 1.0.1 * Added AM/PM selection for 12-hour time formats (dropdown + logic). * Improved CSS for front-end output. * Added validation for special days: prevent past dates and duplicate entries with clear error messages. #### 1.0.0 * Initial public release. * Single global location with weekly opening hours. * Special days/holidays and vacation periods. * “Now open?” badge with human-readable “next change”. * Gutenberg block, classic widget and multiple shortcodes. * JSON-LD output for LocalBusiness opening hours. * Includes several ready-to-use translations. ## 额外信息 * 版本 **1.0.1** * 最后更新：**5 月前** * 活跃安装数量 **10+** * WordPress 版本 ** 6.4 或更高版本 ** * 已测试的最高版本为 **6.9.4** * PHP 版本 ** 8.1 或更高版本 ** * 语言 * [English (US)](https://wordpress.org/plugins/bitkit-opening-hours-holidays/) * 标签 * [block](https://cn.wordpress.org/plugins/tags/block/)[business hours](https://cn.wordpress.org/plugins/tags/business-hours/) [holidays](https://cn.wordpress.org/plugins/tags/holidays/)[Opening Hours](https://cn.wordpress.org/plugins/tags/opening-hours/) [widget](https://cn.wordpress.org/plugins/tags/widget/) * [高级视图](https://cn.wordpress.org/plugins/bitkit-opening-hours-holidays/advanced/) ## 评级 尚未提交反馈。 [Your review](https://wordpress.org/support/plugin/bitkit-opening-hours-holidays/reviews/#new-post) [查看全部评论](https://wordpress.org/support/plugin/bitkit-opening-hours-holidays/reviews/) ## 贡献者 * [ bitkit ](https://profiles.wordpress.org/bitkit/) ## 支持 有话要说吗？是否需要帮助？ [查看支持论坛](https://wordpress.org/support/plugin/bitkit-opening-hours-holidays/)