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 shown in multiple ways, and users can select them to view more information about them.

Calendar Events widget on a page in monthly layout.

Sections in this article:

Considerations

  • Access and content visibility: This widget can display content from connected channels. However, users will only see content to which they have at least Read access.
  • Time zones: By default, events posted in time zones different from the digital workplace will have a time zone indicator that appears only in the Upcoming layout. To turn on this behavior for other layouts, select Always show time zones on calendar events on the Localization page in the Control Panel.

Who can do this?

  • Enterprise administrators
  • Workplace administrators
  • Space administrators
  • Members of the digital workplace with Edit or Full access

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 users with information 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 widget: 

  • Users configuring this widget will only see channels to which they have at least Read access. However, they can still select calendar channels to which they don't have access by selecting groups of calendar channels.
  • 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. 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.
  3. Select a calendar channel from the list of search results. In addition to selecting sources individually, you can select groups of calendar channels:
    • Select All calendars to select all calendar channels in your digital workplace.
    • Select pages or spaces to select all calendar channels below that location.
  4. Repeat this process until you have added all your sources, and then select Done.

To remove sources:

  1. Select add source(s).
  2. Choose the Selected tab, and unselect the source(s) 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 be displayed 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 yet to start.
  • Selected Date Range: A user viewing the widget will see events within the selected range. Use the date picker to select a start and end date.

This setting determines which events are displayed when using the Upcoming layout. However, the start date determines the first day shown in the Daily layout and the initial month of the Monthly layout.
Only show followed content (user context)

Select to only show events that meet both of these conditions:

  • The user is following the event.
  • The event is on a connected source channel.
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.

The default value is 10.
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

(Upcoming layout only) Select to include a link to an event's channel.
Likes

(Upcoming layout only) 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 and 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.