Signagelive and Calendar Widgets require configuration for your Google Calendar account and the associated calendars. To see how to do this, watch the video and read the written instructions below.
The process for setting up a calendar using Google Calendar are as follows:
If you need to reauthenticate the connection to your account or would like to disconnect your account moving forward, please review these sections of the below article:
Signagelive and Calendar Widgets require some configurations to be used with your Google account and the associated calendars. To see how to do this, watch the video and read the written instructions below.
Using the Calendar Integration Application
To begin configuration, you need to go to the Calendar Integration application, which is available from the application drop-down menu within your Signagelive Network. Please see the video above and the instructions below.
Please Note:
Users are not given access to the Signagelive Calendar integration application, an administrator must grant access to each User who requires it.
After logging in, click on your network name at the top of the page and select Edit.
Select the ‘Network Applications’ tab, then click the settings cog associated with ‘Calendar integration’.
Select ‘New User’. This will display a drop-down list of any Users in your network.
Select the User who needs access to the Calendar Integration App.
Any Users selected as part of this process can now access the Calendar integration application.
How do I link a Google account to Signagelive?
To utilise your Google calendars in Signagelive, you must authorise your Google account.
Locate the application list at the top of the page and select ‘Calendar Integration’
Select ‘Services’ towards the top left of the screen
Select the green ‘Authorise’ button aligned with the Google service
You will now be directed to your Google account, where you can provide Signagelive Calendar Integration access to your Google Calendars
Once you have connected your account, you can close this window and return to Signagelive.
Please Note
It is only possible to authenticate a single Google account against a single Signagelive Network.
To promote optimal security, we recommend that you set up accounts specifically for connecting to Signageliv. These accounts only have access to the Calendars required to be used within Signagelive.
How do I disconnect a Google account linked to Signagelive?
To disconnect a Google account:
Locate the application list at the top of the page and select ‘Calendar Integration’
Select ‘Services’ towards the top left of the screen
Select the Red ’Disconnect’ button aligned with the Google service
When disconnecting an account, any rooms created using a calendar linked to the account will be deleted, along with any calendar items synchronised for those rooms.
Any Calendar Apps using an API key for these rooms will no longer show any calendar items.
How do I reauthorise an Google Calendars account with Signagelive?
Locate the application list at the top of the page and select Calendar Integration
Select Services towards the top left of the screen
Click the green ReAuthorise button associated with the Google Calendars service
You will be redirected to Google's sign-in portal, where you can select the Google Calendars account you are re-authorizing
Once done, the account will now be synced up with the Google service again, and your calendar data will appear in your rooms afresh.
How do I create a Signagelive room for my calendar integration?
To create a room with your authenticated calendar account:
Locate the application list at the top of the page and select ‘Calendar Integration’
Click ‘New room’
Next to ‘Name’, enter a desired room name
Next to ‘Service’, use the drop-down menu to select ‘Google’
Next to ‘Calendar’, select the Google Calendar you want to use with Signagelive
Next to ‘Resource’, select the desired resource
Select ‘Save changes’
Upon clicking save, the room will generate an API Key (Copy this now ahead of the next part)
Once you have created the room, Signagelive will synchronise calendar items for the next 90 days for the chosen calendar.
Calendar events will continue to be synchronised at regular intervals so that new, cancelled or edited events are synchronised and up to date. We remove all events older than today from the Signagelive database.
When the room is saved, an API key is created so you can start using it with the Signagelive calendar widgets. Copy this now, as we will need it in the next step.
You can view the items synchronised with Signagelive by viewing the room details at any time within the Calendar Integration application.
Please Note
You cannot edit, delete or create calendar items within the Signagelive Calendar Integration application.
How do I configure the properties of a Calendar widget?
To display your Google calendars, you can use and configure a Calendar widget, which can then be added as part of a playlist.
From the Signagelive dashboard, select Content
Select Playlists
Select Create/ Edit
Press Add (blue +)
Select From the Marketplace
Search for Calendar
Select a Calendar widget of your choosing
Click ‘Add to Signagelive’ to add the Calendar app to your Signagelive network
In the Playlist Creator, select the Recently Added folder
Add the Calendar app to the playlist of your choice
Open the Calendar app properties within the playlist
Set the API key to be the API key for the Room List you want to display
Configure the App setting - Calendar App Properties
Save your playlist, ready for publishing to your chosen calendar player
Please Note
If you wish to show the Calendar Widget for a long period of time, or it is the only asset in your playlist, we recommend setting the duration to a long period of time. This is because the App refreshes its data in the background and there is no need for the whole App to be reloaded regularly. If the duration is set to a short time, you will see a brief flash while the App reloads.
When published to your player, the app calls out to the Signagelive Calendar API and shows calendar items based on the preferences chosen.
Calendar App Preferences
API Key: The API Key which defines the room for which Meetings are shown.
Maximum Number of Meetings to Show: The maximum number of meetings which will be shown in the list views of the Apps.
Show Only Today’s Meetings: If there are less than the maximum number of meetings happening today, should meetings for following days be shown.
Timeline Start Time: If the App has a timeline, what is the earliest time to show a meeting on the timeline.
Timeline End Time: If the App has a timeline, what is the latest time to show a meeting on the timeline.
Timeline Segment Duration: If the App has a timeline, what duration segments should the timeline be split into.