# Calendar Module Guide - Weekly view

**URL:** https://community.xibo.org.uk/t/calendar-module-guide-weekly-view/27112
**Category:** Guides
**Created:** [April 12, 2022, 11:36am UTC](https://community.xibo.org.uk/t/calendar-module-guide-weekly-view/27112 "2022-04-12T11:36:40Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![natasha](https://community.xibo.org.uk/user_avatar/community.xibo.org.uk/natasha/32/18270_2.png) [@natasha](https://community.xibo.org.uk/u/natasha)
#### Post date: [April 12, 2022, 11:36am UTC](https://community.xibo.org.uk/t/calendar-module-guide-weekly-view/27112/1 "2022-04-12T11:36:40Z")

</div>

## This guide is applicable for users of a v3.1 and later CMS

> **Please note:** The [Calendar](https://xibo.org.uk/manual/en/media_module_calendar.html) module is a new module for v3.1  
> The Calendar module which can be found in earlier versions has been renamed [Agenda](https://xibo.org.uk/manual/en/media_module_agenda.html) from v3.1

The Calendar Module has been designed to pull in data from an iCAL feed to display event information in a **Schedule** , **Daily** , **Weekly** or **Monthly** Calendar format.

This step by step guide will take you through the process of creating a **Weekly** calendar view to schedule to displays:

 ![layout_preview](https://community.xibo.org.uk/uploads/default/original/2X/0/04c0b4ea817714577744077f065c20e0444e1d34.png)

For further information on how to view your Google Calendar in applications please take a look at the following link: [Get your calendar (view only)](https://support.google.com/calendar/answer/37648?hl=en)

> Ensure that the ICS feed URL is available to the CMS. If the feed loads in a browser without authentication then the feed should display in the CMS without issue.

## Add Layout

Click on **Layouts** under the **Design** section of the CMS main menu:

- Use the **Add Layout** button.
- I am going to select the **Full Screen** template for this example, click **Next**
- Give the Layout a **Name**
- Select the **Resolution** to use form the drop down menu.
- **Save**.

> Remember, you can select an alternate template to use, but as this Widget could contain a lot of information it is worth keeping in mind the overall design so as to not lose the focus of your audience!

On saving, the [Layout Designer](https://xibo.org.uk/manual/en/layouts_designer.html) will open.

- Open the toolbar and select **Layout Designer Widgets**
- From the list select **Calendar**

 ![add_calendar](https://community.xibo.org.uk/uploads/default/original/2X/0/0cb6b432ececc8fe633a2d7edb3c10569d0f67b8.png)

- Click to add or grab to drag and drop to the empty Region

Once added the properties panel will open with configuration options:

- Give the Widget an optional **Name**

I want to override the default duration for this Widget and provide a duration in seconds:

- Tick the **Set a duration** box to override and I am going to enter 1800 seconds (30 minutes)

Click on the **Configuration** tab:

 ![configuration](https://community.xibo.org.uk/uploads/default/original/2X/7/7eca6822e1bc490fb47ed6ff6107acddcc314dd9.png)

- Provide the **URL** for the iCAL feed to use.
- Use the drop down and select **Weekly** for **Calendar Type**
- Click on the calendar icon and set **Start** and **End Times** to create a viewing window for events in the calendar. I shall set to Start from 7 am to 10 pm to suit my ‘gym’ opening hours.

For this example I can leave the rest of the available options unticked.

> If your calendar has all day events you could use the checkbox to remove these from the feed!

Next go to the **Appearance** tab:

- I can leave the **Time Format** as the default **HH:mm** to apply to the event timings.
- I will enable the **‘Show now marker’** so the current time will be highlighted on the calendar view.
- **Text scale** will leave as **1**.
- Select **Medium** for the **Week name length**.
- I want each row in the grid to represent an hour so can leave **Grid step** as **60** (minutes).
- Select **Light** for the Theme to use the lighter colour scheme for the calendar view.

 ![appearance](https://community.xibo.org.uk/uploads/default/original/2X/7/75d8450c2048dc9e4febf0abd2d2514f43acaf9f.png)

If we now hit the **Save** button at the bottom of the properties panel, we can see how the calendar will look:

 ![region_preview](https://community.xibo.org.uk/uploads/default/original/2X/0/02cbf2b388f1ad1f3bdeacb8913b1f62b0ecd3b1.png)

> Use the button in the top right hand corner of the viewer to toggle to a full screen!

Toggle off from full screen and return to the **Appearance** tab so that we can make some changes to the existing colour template:

- Tick in the **Override colour template** box.

If we now scroll down the properties panel, you can see all the elements of the calendar which can have your own chosen colours:

 ![colour_override](https://community.xibo.org.uk/uploads/default/original/2X/7/7520bb1ad583d5945a504db65af26e6318e73a69.png)

> Save and preview as you go.

- Use the **Caching** tab and provide an **Update Interval** (in minutes) as high as possible.I have set this to 60 which will mean that the Widget will check for new entries in the iCAL feed every hour

Click the back arrow in the top left of the viewer and play a full **Preview** of the Layout.  
If everything is showing as intended use the menu to set the Layout to **Publish** , ready to be scheduled to Displays.

 ![publish_layout](https://community.xibo.org.uk/uploads/default/original/2X/b/b5167288d239b9c15846c614379f74807c418a78.png)

Next why not try selecting a different Calendar Type and configuring to see what best suits your use case!

> Take a look at our [Agenda Module Guide](https://community.xibo.org.uk/t/agenda-module-guide/26993) which gives an another example of how to utilise an iCAL feed to give a customer facing display!
