Calendar¶

Use the Calendar web part to display events from a selected Events List, or roll up multiple events lists from many sites.

Layout¶

Setting	Description
Calendar View	Displays events in a calendar month view
Events Rollup	Displays a rollup list of events

Choosing a source¶

Setting	Description
Single List Events	Returns events from a specified events calendar in the provided site
Events Rollup	Returns events based on the search query
Team Events	Returns events based on the selected team

The default mode is Events Rollup, which combines events from multiple Event lists into one view.

Events Rollup¶

User's have the option of narrowing down which sites are used when collecting events for the rollup view:

Calendar: Scope

All Sites¶

Events are gathered from all sites the current logged on user has access to

Hub¶

Events are gathered from all sites the current logged on user has access to that are Associated with the current Hub Site.

Site¶

Events are gathered from all Event Lists in the current site

Result Source¶

A result source ID can be added here, and the query to gather the events will use the Result Source.

Single Event List¶

Calendar: Single List

Choose a single List for which to show Events. Enter the URL of a site, then choose the relevant Events List from the dropdown.

If the URL text box is blank, the current site is used to populate the dropdown list.

Team Events¶

Select a team the user is currently a member of.

Viewing Events¶

Clicking on any event will open that event's details page in a new tab.

If there too many events to display in a single day's tile in the calendar, a link to "Show More" will appear at the bottom of that day.

Calendar: Show More

Clicking this link will display all events on that day in a Panel.

Calendar: All Events

Clicking on any event will also open that event in a new tab. User's can also download an ICS file for each event by clicking on the download icon on the left of each event, user's can "share" out the event by clicking the Share icon on the right. This Share icon opens a new email window in an email client, with some pre-defined text and a link to download the ICS file.

Other Options¶

Height¶

Control the height of the calendar using the slider.

Calendar: Height

Category Colours¶

Control how the events are rendered by using the Categories assigned to each event, and specifying a colour using the Configuration Panel.

Calendar: Colours

Note

You may need to be a site owner to gain access to the Mercury Configuration Panel

Config Repository¶

This web part supports use of the config repository, to allow users to save and load configurations of web parts with ease.

Loading a config file will populate the web part properties with properties from the incoming file.

SharePoint¶

Saving to SharePoint allows collaboration between users in a tenant.

The path the file is saved to is tenant-name/Site Assets/Mercury Assets/webpart-name.json.

Permissions¶

To save a file to SharePoint, edit permissions are required on the root Site Assets library.

To load a file from SharePoint, read permissions are required on the root Site Assets library.

OneDrive¶

Saving to OneDrive allows a user to save a file locally, this is the best option when a user does not have the required permissions to save to SharePoint.

The path the file is saved to is Mercury Assets/webpartname.json.