Calendar Listings

The YSM Office of Communications frequently receives requests for assistance with inserting and/or editing calendars. While we provide instructions for how to implement a calendar on your site, we do not edit the content on your organization's calendar, such as editing existing events.

Tridion uses Calendar data from the Profile System to fill out the Calendar listings.

The following instructions provide information on creating Calendar Listings in Tridion using Profile System data, as well as the different display options for those Listings.

Table of Contents

Creating a Calendar Component

The first step in creating a Calendar Listing is to create a Calendar component.

Open

In the Building Blocks folder of your respective website, click New Component (highlighted in blue above) in the Create tab (highlighted in yellow above) of the navigation bar.

You will be taken to a new page for creating the component (shown below):

Open

1. Enter an appropriate Name for your component.

2. Choose Calendar from the Schema drop down menu (highlighted in yellow above).

3. Title: Enter the Title you want to appear above the listing.

4. Introduction Text: You can add text above the listing that introduces or explains the calendar.

5. Calendar alias: Enter the appropriate alias for the calendar you want the listing to show, which is the Calendar’s page name.

   • You can find the Calendar’s page name in the profile system.

     • Click on the Organizations tab in the top navigation.

     • Find the organization in the list or use the Filter field to narrow the list.

     • Click the pencil/edit icon to the right of the organization.

     • Click Calendars in the left navigation for the organization.

     • In the Calendars List section, click the pencil/edit icon next to the Calendar you want to use for your listing.

     • You will find the alias in the Page Name field.

6. Show events in the past or the future?: Select if you would like this calendar to display events from the Future or from the Past. 

   • Most calendars should use Future, the Past option is only to display an archive of past events.

7. The field for Number of events to display will be pre-populated with 10, change this to display more or less events based on your departments calendared items.

8. The field for Number of days to display will be pre-populated with 30 days, this can be adjusted.

   • To show all events in the next year just enter 365.

9. If you are using a calendar alias and that calendar uses keywords, the Keywords to Display field allows you to limit this calendar to display ONLY items tagged with those keywords.

   • Click the green + icon to add a keyword (highlighted in green above).

   • Once you’ve added keywords, you can delete them with the trashcan icon or sort them with the move icon (highlighted in green above).

10. Filter by audience: Use these check boxes to determine which types of events in the Calendar are displayed.

    • These choices come from the Audience field when creating or editing an event (see https://ysmweb.atlassian.net/wiki/spaces/HELP/pages/1709277772 for more information).

    • The choices determine who can see an event.

When you have added the desired information, click Save and Close (highlighted in blue above), and you are ready to add it to a page.

Adding the Calendar Component to a Page

After creating the Calendar component, you can add the component to a page as a Listing template.

1. Navigate in the Root folder to the page you'd like to add a Calendar Listing to and double-click to open the page.

2. In the window that opens, click the Component Presentations tab.

3. Click Insert at the bottom left of the page window.

4. Browse to the Calendar component you created and click to select it.

5. From the Component Template dropdown, select one of the following templates (visit the linked pages for examples):

   • https://ysmweb.atlassian.net/wiki/spaces/HELP/pages/1830027663

6. Click the Insert button at the bottom right, then the Close button.

7. Save and Close the page, then you are ready to publish.