---
title: "Opening Hours module"
---

# Opening Hours module

Note: This documentation applies to Opening Hours Module v6. Not all options/features might not be available in older versions.   
For v4 visit [our legacy docs](https://docs.joomill-extensions.com/opening-hours-module).


## Install the module

Before installation please check that the below system requirements are met. You can ask your webhoster if the server you are working on supports them. You can also find the information in the Joomla! backend under System > System information.

 
## General requirements

 
- Joomla! 4.x or 5.x or 6.x  
*You can still download Opening Hours module for Joomla 1.5, 2.5 or 3.x (this version will not have the latest features)*

 Support for Joomla! 1.5 ended September 2012.   
Support for Joomla! 2.5 ended March 2015.   
Support for Joomla! 3.10 ended August 2023.

 ## Preparations

 
- Create a full backup of the website. You can use [Akeeba Backup](http://www.akeeba.com) to create a quick one
- Upgrade to the latest version of Joomla!

 
## Installation (upload & install)

 The installation of our extensions is done with the Joomla! installer. Anyone that is already using Joomla! shouldn't have any problem, for those that are somewhat new in Joomla! we'll explain the steps required to make the installation of the extensions in your website.

 1) After downloading the installation file from our website, go to your Joomla! administration and go to **System > Install > Extensions**

 ![install 01](https://joomill-templates.com/images/documentation/general/install-01.jpg)

 2) Then select the file in the tab **Upload Package File**, after a few moments you'll get a message saying the extension is installed.

 ![install 02](https://joomill-templates.com/images/documentation/general/install-02.jpg)

 3) The module need to be published manually. Go to **Extensions** » **Extension Manager,**find the Opening Hours module, select a module position, Menu Assignment, and **Publish **the module

 Now you're ready to start using our extension!

 
## Installation (Install from web)

 1) Go to your Joomla! administration and go to **System > Install > Extensions**and select the**Install from Web**tab

 Search for **Joomill** to find my extensions

  ![install from web](https://joomill-templates.com/images/documentation/general/install-from-web.png)

  


[Lees meer...](https://joomill-templates.com/opening-hours-module/install-the-module.md)

## Regular Opening Hours

You can use this form for regular opening hours.

 ![exceptional settings](https://joomill-templates.com/images/documentation/openinghours/regular-settings.jpg)

 
|  |  |
| --- | --- |
| Opening Hours | Enter the opening hours for this days. You can use 2 lines of openings a day.

 Specify your hours using 24-hour format. For example, 3pm is entered as 15:00  
Use a '-' to separate opening and closing hours. Spaces are allowed.  
You can also use a custom text like: CLOSED  |


[Lees meer...](https://joomill-templates.com/opening-hours-module/regular-opening-hours.md)

## Exceptional Opening Hours

**Exceptional Opening Hours** is only available in the PRO version.  
Unlock this and other features by upgrading to **Joomill Opening Hours PRO**  
  
[Go PRO](https://joomill-templates.com/subscribe/order/product/openinghours-pro)

 You can use this form when your opening hours differ from the regular opening hours.

 Click on the green + button to add a new date(-range)

 ![exceptional settings](https://joomill-templates.com/images/documentation/openinghours/exceptional-settings.jpg)

 
|  |  |
| --- | --- |
| From Date | Enter a date in DD-MM-YYYY (or select a day with the calendar button) from when the exceptional opening hours apply.  |
| To Date | Enter a date in DD-MM-YYYY (or select a day with the calendar button) till when the exceptional opening hours apply.   
You can leave this field empty when you only need 1 day. If empty only the From Date will be used |
| Opening Hours | Enter the opening hours for this exceptional days. You can use 2 lines of openings a day.

 Specify your hours using 24-hour format. For example, 3pm is entered as 15:00  
Use a '-' to separate opening and closing hours. Spaces are allowed.  
You can also use a custom text like: CLOSED or Holidays  |
| Yearly Recurring | Set this date as yearly recurring. Useful for events like Christmas or national holidays. The year in the From Date and To Date field will be ignored. |

 
## Upcoming Exceptional Opening Hours

 You can show the next exceptional openings at the bottom of the module. You can add an intro text, css class and number of days in the settings. 

  ![upcoming](https://joomill-templates.com/images/documentation/openinghours/upcoming.jpg)

 
|  |  |
| --- | --- |
| Show Upcoming Exceptional Openings | Select Yes or No |
| CSS Class | Add a css class for styling the upcoming exceptional hours in your template.  
Default: alert alert-info |
| Title  | Add an title or introtext to your upcoming exceptional hours in the textarea. You might use HTML. |
| Number of Days to Look Ahead | Enter the number of days to look ahead. When no exceptional openings are found within this range, the block will be hidden.  
Default: 30 (days) |

 ![upcoming settings](https://joomill-templates.com/images/documentation/openinghours/upcoming-settings.jpg)


[Lees meer...](https://joomill-templates.com/opening-hours-module/exceptional-opening-hours.md)

## Display Options

|  |  |
| --- | --- |
| Module Width | Setup the width of the module (default: 100%) you can setup the width in % (like 90%) or in px (like 200px). |
| Day / Date / Time Width (PRO ONLY) | Setup the width of the day, date or time column (default: 30%) you can setup the width in % (like 20%) or in px (like 20px)**.** |
| Day / Date / Time Align | Select the alignment of the day, date or time column. You can choose "Left", "Center" or "Right". |

 ![display settings](https://joomill-templates.com/images/documentation/openinghours/display-settings.jpg)


[Lees meer...](https://joomill-templates.com/opening-hours-module/display-options.md)

## Date & Time settings

These settings can be found in the "**Display options**" tab.

 
|  |  |
| --- | --- |
| Date Format (PRO ONLY) | Choose your favorite date format which will be displayed in the frontend. The most popular parameters are:

 
- d-m-Y (31-12-2014)
- d-m-y (31-12-14)
- m-d-Y (12-31-2014)
- M dS (Dec 31th)
- j. M Y (31. Dec 2014)
- d F (31 December)

 See [http://php.net/manual/en/function.date.php](http://php.net/manual/en/function.date.php) for a complete list of parameters. |
| Time Format | Choose your favorite time format which will be displayed in the frontend. The most popular parameters are:

 
- H:i (18:30)
- h:i A (06:30 PM)
- H:i a (18:30 pm)
- gA (6PM)

 See [http://php.net/manual/en/function.date.php](http://php.net/manual/en/function.date.php) for a complete list of parameters. |
| Open Suffix (PRO ONLY) | Text to show after opening time like hrs. or uur. Leave empty to display nothing.

 **example:**  
08:00 uur - 16:00 |
| Close Suffix (PRO ONLY) | Text to show after closing time like hrs. or uur. Leave empty to display nothing.

 **example:**  
08:00 - 16:00 uur |
| Time Zone  | Select your Time Zone of your shop. This setting will be used in the highlight-options and currently status. |
| Hide All openings (PRO ONLY) | Don't display any opening hours. You can use this to only display the currently open/closed status. |
| Show only today (PRO ONLY) | Displays only today and hide all other opening hours. |
| Week Starts on | Select the first day of the week. You can choose "Saturday", "Sunday", "Monday" or "Next 7 days". (PRO ONLY) Next 7 days will show today on top with upcoming days. |
| Show Monday to Friday (PRO ONLY) | Displays only Monday till Friday and hide the weekend. |
| Show Dates (PRO ONLY) | Displays/hides the Date column. |

 ![datetime settings](https://joomill-templates.com/images/documentation/openinghours/datetime-settings.jpg)


[Lees meer...](https://joomill-templates.com/opening-hours-module/date-time-settings.md)

## Highlight settings

These settings can be found in the "**Display options**" tab.

 
|  |  |
| --- | --- |
| Highlight Today | With this option you can show today's opening hours in a fancy way. |
| Highlight Color (PRO ONLY) | Display today in another color. You can select your favorite color here.  |
| Bold Text (PRO ONLY) | Display today in **Bold**. |
| Italic Text (PRO ONLY) | Display today in *Italic*. |

 ![highlight settings](https://joomill-templates.com/images/documentation/openinghours/highlight-settings.jpg)


[Lees meer...](https://joomill-templates.com/opening-hours-module/highlight-settings.md)

## Notes

**Notes** are only available in the PRO version.  
Unlock this and other features by upgrading to **Joomill Opening Hours PRO**  
  
[Go PRO](https://joomill-templates.com/subscribe/order/product/openinghours-pro)

 
|  |  |
| --- | --- |
| Show Notes | Display notes at Top or Bottom of the module. |
| Notes CSS Class | Enter a css class for styling notes in your template. |
| Notes | Enter your notes in the textarea. you might use HTML. |

 ![notes settings](https://joomill-templates.com/images/documentation/openinghours/notes-settings.jpg)


[Lees meer...](https://joomill-templates.com/opening-hours-module/notes.md)

## Currently Open

**Currently Open/Closed** is only available in the PRO version.  
Unlock this and other features by upgrading to **Joomill Opening Hours PRO**  
  
[Go PRO](https://joomill-templates.com/subscribe/order/product/openinghours-pro)

 In this tab you can setup if you would like to show the status of your shop.

 In the frontend it will look like:

 ![currently open](https://joomill-templates.com/images/documentation/openinghours/currently-open.jpg) ![currently closed](https://joomill-templates.com/images/documentation/openinghours/currently-closed.jpg)

 
|  |  |
| --- | --- |
| Current Status position | Display Currently open / closed message at Top or Bottom of the module. |
| Show Currently Open Message | Show a message when your business is open. |
| Open CSS Class | Set a CSS Class for the Currently Open message.   
Default: alert alert-success text-center |
| Currently Open Message | Enter a message when your business is open. You might use HTML like <div>, <h4>, etc. |
| Show Currently Closed Message | Show a message when your business is closed. |
| Closed CSS Class | Set a CSS Class for the Currently Closed message.   
Default: alert alert-danger text-center |
| Currently Closed Message |  Enter a message when your business is closed. You might use HTML like <div>, <h4>, etc. |

 ![currently settings](https://joomill-templates.com/images/documentation/openinghours/currently-settings.jpg)


[Lees meer...](https://joomill-templates.com/opening-hours-module/currently-open-closed.md)

## Microdata

**Microdata** is only available in the PRO version.  
Unlock this and other features by upgrading to **Joomill Opening Hours PRO**  
  
[Go PRO](https://joomill-templates.com/subscribe/order/product/openinghours-pro)

 In this tab you can setup the microdata of your website.

 Your website will be more meaningful, accessible by search engines and it will be ranked more relevantly to its search queries.

 ![microdata](https://joomill-templates.com/images/documentation/openinghours/microdata.jpg)

 
|  |  |
| --- | --- |
| Use Microdata | Select yes or no. |
| Business Type | Enter your business type. |
| Company Name | Enter your company name. |
| Company Description | Enter your company description. |
| Address | Enter your address. (street + number) |
| ZIP Code  | Enter your ZIP code. |
| City | Enter your city. |
| Region | Enter your region. |
| Country | Enter your country. |
| Google Maps | Enter the link to your Google Maps location. |
| Latitude | Enter your latitude. |
| Longitude | Enter your longitude. |
| Phone Number | Enter your phone number. |
| E-mail | Enter your E-mailaddress. |
| URL | Enter your Website URL. |
| Price Range | Enter your Price Range. |
| Logo | Enter the link to your logo. |

 
## Microdata results:

 ![microdata results](https://joomill-templates.com/images/documentation/openinghours/microdata-results.jpg)


[Lees meer...](https://joomill-templates.com/opening-hours-module/microdata.md)

## Content plugin

**The Opening Hours Content plugin** is only available in the PRO version.  
Unlock this and other features by upgrading to **Joomill Opening Hours PRO**  
  
[Go PRO](https://joomill-templates.com/subscribe/order/product/openinghours-pro)

 **Opening Hours module v6.0.0 Beta 2 or later is required**

 This plugin allows you to show or hide content in Joomla articles and modules (based on your settings from the Opening Hours module)

 When you use this a custom HTML module, make sure you enable the prepare content option in the options tab of the custom HTML module.

 
### Current Status Shortcode:

 You use a shortcode like this and the text will only be visible if the business is currently open (or closed, if you set status="closed")

 `{openinghours status="open"}Your text when open here{/openinghours}`

 optional: When you have multiple modules, you can target a specific module with module="MODULE-ID".

 `{openinghours status="closed" module="114"}Your closed text here{/openinghours}`

 
### Today Shortcode:

 `{opentoday}Your text when you are open today{/opentoday}`

 `{closedtoday}Your text when you are closed today{/closedtoday}`

 optional: When you have multiple modules, you can target a specific module with module="MODULE-ID".

 `{opentoday module="114"}Your text when you are open today{/opentoday}`

 `{exceptionaltoday} Your text when today has exceptional openinghours {/exceptionaltoday}` - Conditional content shown only if there are any exceptional opening hours for today

 Example: `{opentoday}Today we are open from {opentime} till {closetime}. {/opentoday}`

 
### Dynamic tags:

 Inside the shortcodes you can add these dynamic tags:

 `{opentime}` - Show the 1st openingshours of today

 `{closetime}` - Show the 1st closinghours of today

 `{opentime2}` - Show the 2nd openingshours of today

 `{closetime2}` - Show the 2nd closinghours of today

 `{currentdate}` - Show the current date (based on the settings of the module)

 `{currenttime}` - Show the current time (based on the settings of the module)

 ``optional: When you have multiple modules, you can target a specific module with module="MODULE-ID".

 Example: `{opentime module="114"}`

 The date- and timeformat used in this plugin is based on the settings of the module. you can override this with the format-attribute inside the tag.

 Example: `{currentdate format="d-m-Y"}`

 Example: `{closetime format="H:i"}`

  

 Configuration is not applicable: just enable the plugin and you are good to go!


[Lees meer...](https://joomill-templates.com/opening-hours-module/content-plugin.md)

## Changelog

[changelog-openinghours]


[Lees meer...](https://joomill-templates.com/opening-hours-module/changelog.md)