Opening Hours

Description

  • Supports multiple Sets of Opening Hours (e.g. one for your restaurant and one for your bar) that you can use independently.
  • Supports Holidays
  • Supports Irregular Openings (e.g. different opening hours during Christmas)
  • Supports child sets that overwrite your regular opening hours in a specific time period (e.g. seasonal opening hours or an extra day in every second week)
  • Four highly customizable Widgets and Shortcodes also displaying contextual information (e.g. “We’re currently closed but will be open again on Monday at 8am”)

Widgets

  • Overview Widget: Lists up all Opening Hours with contextual information in a table or list
  • Is Open Widget: Indicates whether the selected venue is currently open or closed and optionally shows when it will be open again
  • Holidays Widget: Lists up all Holidays in a table or list
  • Irregular Openings Widget: Lists up all Irregular Openings in a table or list
  • Schema.org Widgets: Inserts structured JSON-LD into a WordPress page or post

More on Widgets

Shortcodes

All of the widgets listed up above are also available as shortcodes.
With the Opening Hours Shortcode Builder you can assemble a Shortcode by filling in a form. This is particularly useful when you are not comfortable with the shortcode syntax.

Further Documentation

Further documentation is available on GitHub.

Installation

There are multiple ways to install the Opening Hours Plugin

  1. WordPress Plugin Installer
  2. Manual Installation
  3. Composer
  4. Clone GitHub Repository

FAQ

How can I change the styling of the widgets / shortcodes?

The Plugin provides very minimal styling, which is the red and green colors for the open / closed messages. All other kind of styling is left to the WordPress Theme you are using or your custom CSS.
To disable the styling of the text color the op_use_front_end_styles filter hook can be used.

My language is not provided in the Plugin

You can participate to Plugin translations to make it available in more languages.
Please read the section on contributing to translations

I found a bug and I would like to fix it

If you found a bug you would like to fix feel free to contribute to the project on GitHub.

Reviews

June 6, 2020
Absolutely great plugin! I used it in DIVI-builder with only the shortcodes and so much is adjustable. It perfectly fit my needs.
January 3, 2020
I've moved a site from editing three pages (for three separate languages and using tortuous table html) to instead editing one easy to use panel with dropdowns. It's sooooo much simpler for the end user. I needed to do a little bit of extra coding to make things look exactly as I wanted, but the plugin author was patient and helpful. Thanks Jannik!
July 22, 2019
It offers countless features and can be used anywhere. Thank you to the author(s)
July 5, 2019
This is one of the best free plugins out there. So many shortcodes, it can display exactly how you need it to. Thanks to the developer! I will donate as soon as I can. To the person who had issues with incorrect display shown, I had that initially but realised it was my incorrect settings - general - timezone.
June 26, 2019
Je l'utilise pour afficher les horaires d'ouverture et de fermeture de mon magasin et il fonctionne à merveille. Je recommande!!
Read all 37 reviews

Contributors & Developers

“Opening Hours” is open source software. The following people have contributed to this plugin.

Contributors

“Opening Hours” has been translated into 7 locales. Thank you to the translators for their contributions.

Translate “Opening Hours” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

2.3.0

  • Fix a bug that would cause redundant database writes caused by a DB_VERSION mismatch
  • Add filter op_shortcode_template_path
  • Deprecate filter op_shortcode_template in favor of op_shortcode_template_path
  • Consistently use en dashes to separate dates and times in default formats
  • Add filter op_set_post_type_arguments

2.2.1

  • Add support for custom user locales in the admin panel for cases when the user locale differs from the site locale

2.2.0

  • Added [op-schema] shortcode and Schema.org Widget for structured JSON-LD representation of opening hours, holidays and irregular openings
  • Added button for Shortcode Builder in Set edit page

2.1.4

  • Fixed a warning occuring in the Overview shortcode with PHP >= 7.2
  • Added method OpeningHours->clearSetProviders() to OpeningHours singleton

2.1.3

  • Fix concerning time formats of Irregular Openings and Periods when saving by @Braunson

2.1.2

  • Fixed JavaScript conflicts with other plugins

2.1.1

  • Fixed a bug that did not load the parent set’s irregular openings and holidays in active child sets.
  • Fixed a bug that blocked irregular openings and periods on the days after irregular openings that go beyond midnight.

2.1

  • Added today’s opening hours in Is Open shortcode / widget
  • Automatically hide past Holidays and Irregular Openings in the respective shortcodes / widgets
  • Sort Holidays and Irregular Openings ascendingly by start date
  • Use WordPress shipped version of jquery-ui to prevent conflicts with other plugins
  • Merge dates of Holidays if they only span one day
  • Added offset option to Overview shortcode / widget
  • Added filters
    • op_is_open_format_next
    • op_is_open_format_today
    • op_overview_model
  • Various bug fixes

2.0.5

  • fixed bug concerning child set initialization. thanks to @nikomuse

2.0.4

  • Added support for UTC offset timezones

2.0.3

  • Fixed timezone bug in WordPress 4.7

2.0.2

  • Fixed a bug that didn’t show next open Period when there are no regular Periods but Irregular Openings in the current Set

2.0.1

  • Added SetAlias functionality
  • Minor fixes including:
    • Fixed mixed content error (@foomep)
    • Fixed auto convert issue
    • Fixed PHP 5.3 incompatibility issues

2.0

Completely new version of the Opening Hours plugin.
Supports multiple Sets of Opening Hours and adds more flexibility to the Widgets and Shortcodes.
Offers Developer APIs to easily integrate your custom sources.

1.2

Read this article:
http://www.jannikportz.de/2014/01/19/update-1-2-for-opening-hours-plugin/

1.1.1

Read this article:
http://www.jannikportz.de/2013/12/04/opening-hours-update-1-1-1/

1.1

Read this article:
http://www.jannikportz.de/2013/11/03/opening-hours-update-version-1-2/

1.0.1

fixed a bug that displayed saturday instead of friday
ATTENTION: REINSTALL NECESSARY!

1.0

initial version