Widget: Event Calendar
This widget displays user-defined calendar data in chronological order. The scheduled information can be presented in hour, day, week, or month format. It is commonly used for:
- Displaying the agenda of the current day/week/month for a specific event or location.
- Enabling easy, instant announcements on changes to events scheduled during a particular time-period.
- Sharing of new content and updates for rapid deployment to event participants/ viewers of the widget.
Click on the following for help with:
- Adding an Event Calendar Widget
- Configuring the Event Calendar Widget
- Integrating with External Data Sources
- Google Calendar Integration
- Microsoft Exchange 2007 - 2010 Integration
Adding an Event Calendar Widget
To add an Event Calendar widget to your signs, follow the instructions in the Adding Widgets section in the Managing Widgets article and select the Event Calendar widget in the Widget Library.
Configuring the Event Calendar Widget
To configure an event calendar widget’s properties, please follow the instructions below:
- Configuring PROPERTIES
- Configuring Additional Field Names
- Adding a New Event
- Editing or Deleting an Event
Configuring PROPERTIES
In your sign layout, click the Event Calendar widget name under the Widgets section.
In the Widget Properties window, configure the common tabs as per this article: Configuring Widget Properties.
In the Widget Properties window, click the APPEARANCE tab.
Edit the properties sections as per the following:
- Template: Preset layouts to display the event information.
- Resolution: The dimensions of the text.
- Context: The option to display events in the current hour, the current day, current week or current month.
- Preroll Time: How long before the start of an event will the event be displayed, expressed in minutes. For example if the event starts at 9am, specifying 30 minutes as Preroll Time means that the event will be displayed starting at 8.30am.
- No of Events: Number of events to display per page. If there are more events, the widget will cycle through all the events.
- Item Range: The total range of calendar items to display.
- No Event Msg: What message to display when there are no events scheduled in the calendar.
- Rotate Duration: Duration to display each page of calendar events.
- Show Past Event: The option of displaying past events.
- Filter Location: The ability to display events based on the location property. (Location names must not have spaces).
- FONT: Utilizes tabs for customizing the look of the calendar.
- EVENT and TIME: using a variety of formatting options, including font type, size, alignment and color.
Configuring Additional Field Names
Field names are additional configurable fields that can be used for event related information. For example, you can add ‘the number of people involved in an event’ as a field name. To add and configure field names:
Note
Additional Field Names is only supported on the Appspace for Windows (DirectX), and requires custom coding on the DirectX player to be displayed.
In the Widget Properties window, click the CONFIGURATION tab.
In the Additional Fields section, input the field name and select a field type. Click the green tick to add.
Repeat the step to add more fields.
Click the Save button.
You will see a notification when the field name has been successfully saved.
To edit your field name, click the pencil button and make the necessary changes.
This field name will be available when adding a new event.
Adding a New Event
To add an event to the calendar widget:
Editing or Deleting an Event
To edit or delete an event:
Integrating with External Data Sources
You can integrate the Event Calendar Widget with external data sources such as Microsoft Exchange and Google Mail. Event calendar maps the calendar data sources to its internal representation of calendar data as illustrated in the following diagram.
Google Calendar Integration
To integrate Google Calendar with the Event Calendar widget, follow the instructions below.
Enable Google API
Login to https://console.developers.google.com using your Gmail credentials.
In the Google Developer Console, select an existing project, or create a new project.
Once a project has been selected or created, in the API Manager, select Library, and click the Calendar API link.
In the Google Calendar API dashboard, click ENABLE.
Once the Google Calendar API has been enabled, click ‘Create credentials’ to access the Credentials page.
In the ‘Find out what kind of credentials you need’ section, select the following answers to the questions below:
Which API are you using? Google Calendar API Where will you be calling the API from? Web Browser (Javascript) What data will you be accessing? User data In the ‘Create an OAuth 2.0 client ID’ section, fill in the required information as per the fields below, and click the ‘Create client ID’ button once complete.
Field Information Name <Product Name> Authorized JavaScript origins http://{server URL}, if you’re using Appspace Cloud, please use either https://nc01.appspace.com, https://nv01.appspace.com, https://app1.appspace.com, or app3.cloud.appspace.com depending on your cloud server Authorized redirect URIs http://{server URL}/app/application-widget-properties.aspx In the ‘Set up the OAuth 2.0 consent screen’, select the email address, and enter in the Product Name. Click the ‘Continue’ button once complete.
Click Done.
Click the newly created OAuth Client ID, and take note of the Client ID, and Client secret.
Configure Event Calendar for Google Calendar
In the Widget Properties window, click the CONFIGURATION tab.
In the Type drop-down menu, select Google Calendar as your provider type.
Fill in the Google Username, Client ID, and Client Secret. You would have obtained the client ID and secret from the previous section.
Proceed to set the Time Display, Time Zone and Frequency fields.
Click Save on the top right. You will see a notification when the configuration has been successfully saved.
Note
Minimum frequency setting is 15 minutes.
Microsoft Exchange 2007 - 2010 Integration
To integrate Microsoft Exchange 2007 - 2010 with the Event Calendar widget, follow the instructions below.
Configure Event Calendar for Microsoft Exchange
In the Widget Properties window, click the CONFIGURATION tab.
In the Type drop-down menu, select Exchange 2007 - 2010 as your provider type.
Fill in the Exchange URL, username and password.
Additionally, you can also add a room calendar to retrieve events from.
Proceed to set the Time Display, Time Zone, Frequency and Look Ahead fields.
Click Save on the top right. You will see a notification when the configuration has been successfully saved.