Calendar Events widget

Use a Calendar Events widget to display events from one or more calendar channels on a page, space, or dashboard. Events can be displayed in multiple ways, and users can select these events to view more information about them.

Sections in this article:

Access and content visibility

This widget can display content from connected channels. However, users will only see content that they have at least Read access to

Time zones

By default, events posted in time zones different from the digital workplace’s time zone will have a time zone indicator appear in only the Upcoming layout. Turn on this behavior for other layouts by selecting the option Always show time zones on calendar events located on the Localization page in the Control Panel.

Set up

Follow these steps to set up this widget:

  1. Place a  Calendar Events widget on a page, space, or dashboard. For more information, see Placing and setting up a widget. 
  2. Select the placed widget's Edit button.
  3. Review and make changes to the settings on the Options, Layout, and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  4. In the widget editor, select Update to apply your changes or Cancel to discard them.  
  5. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.

Settings

Setting Description
Title Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a title for each supported language.  

This field can contain a maximum of 140 characters.
Title link Enter the URL of a location in your digital workplace. Users who select the widget's title, if it has one, will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter, it will convert to an absolute URL the next time you edit the widget.
Description

Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.
Source(s)

Select from which calendar channel(s) the widget displays content.

Access rules determine what users will see when configuring and viewing the ridget: 

  • Users who are configuring this widget will only see channels to which they have at least Read access. Users can still select calendar channels that they don't have access to by selecting groups of calendar channels (see step 4 of adding sources below).
  • Users who view the published widget will only see content from a calendar channel if they have at least Read access to that content.

To add sources:

  1. Select add source(s).
  2. Select the Calendars tab.
  3. Search for a calendar channel by its name or a portion of its URL. This search will return up to 100 results and include the pages and spaces that contain a calendar channel that matches the search query.
  4. Select a calendar channel from the list of search results. In addition to selecting sources individually, you can select groups of calendar channels:
    • Select the All option to select all calendar channels in your digital workplace.
    • Select pages or spaces to select all calendar channels below that location.
  5. Repeat this process until you have added all your sources, and then select Done.

To remove sources:

  1. Select add source(s).
  2. While on the Selected tab, unselect the source(s) that you want to remove.
  3. Select Done.
Show

Show events from within the selected date range. Only events within this date range and from the connected source channels will display in the widget. Select one of the following options: 

  • Upcoming: A user viewing the widget will see events that are currently in progress or have not yet started.
  • Selected Date Range: A user viewing the widget will see events that occur within the selected range. Use the date picker to select a start and end date.

This setting determines which events display when using the Upcoming layout. However, the start date does determine the first day shown in the Daily layout, and the initial month of the Monthly layout.
Only show followed content Select to show content based on a user's subscriptions. Only content that the user is following and from the connected source channels will display in the widget.
Number of results

Enter the maximum number of results to increment by, and to display initially. You must enter a value between 1 and 99. If there are additional items to display, users can select the Load More link found at the bottom of the feed to load additional results.

This setting only applies to results in the Upcoming layout.
Show add link Select to add an Add Event button to the widget. Only users with at least Write access to any of the connected calendar channels can see this button. Users can select this button to add content to calendar channels to which they have at least Write access.
Show follow icon Select to add a  Follow button to the widget. Users can select this button to subscribe to all channels displayed in the widget to which they have at least Read access.
Options tab
Setting Description
Layout

Select how the widget displays events. Options include:

  • Upcoming: Display upcoming events. Users can select Load More to display events that occur further in the future.
  • Daily: Display the events that occur on a specific day. Users can cycle through days.
  • Monthly: Display a calendar with events on it. Users can cycle through months.
Customize layout

Select how the layout is formatted. Options include:

  • Standard: Select this option when the widget is not in a narrow side column.
  • Compact: Select this option when the widget is in a narrow side column
Channel

This option is only available if the Layout is Upcoming.

Select to include a link to an event's channel.
Likes

This option is only available if the Layout is Upcoming.

Select to include a Like button on events. Users can select this button to add a like or select the number of likes to see who has liked the event.
Layout tab
Setting Description
Class Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets.
Height Select the height of the widget. Options include:
  • Auto: The leftmost slider position. The height of the widget will increase and decrease to contain what it is displaying.
  • Fixed: Select a fixed height between 50px to 600px in increments of 50px. A vertical scrollbar will appear on the widget if the content exceeds this fixed value.
Appearance tab

Note

Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.