Rolling Calendar Page
Last Updated: 02 Feb 2018
page_calendar_rolling|asset|5.5.0.0
The Rolling Calendar Page allows you to show a list of events for a period of time. This time will keep moving forward as time passes by. For example, you can create a Rolling Calendar Page that shows the events for the next seven days. If today was the 1st December, the page will show the events for the 1st December through to the 7th December. On the 2nd December it will show the events for the 2nd December through to the 8th December. These events can either be individual one-off events (know as Single Calendar Event), periodically recurring events (know as Recurring Calendar Event) or a combination of both (know as Multi-Date Calendar Event).
Bookmarks to the headings on this page:
Adding a Rolling Calendar Page
When you add a new Rolling Calendar Page, the Create new Rolling Calendar Page screen will appear. The Details section of this screen is shown in the figure below.
Enter the following details for the Rolling Calendar Page asset:
- Name: enter a name for the page.
- Event Sources: select which section of the system to get the events from. For example, if you want to show all of the events in your Site, select your Site in this field. To select more than one section, click the More button.
Once you have entered the required information, click Commit. The Rolling Calendar Page will appear in the Asset Map on the left hand side of the screen. You can configure the settings of the Rolling Calendar Page on its associated asset screens. The majority of these screens are the same or similar to those of a Standard Page and Asset Listing and are described in either the Asset Screens manual or the Asset Listing manual. In this chapter, we will describe the Details screen, which is different for a RollingCalendar Page.
Additional Dependant Assets
When you create a Rolling Calendar Page, several assets are automatically created beneath it, as highlighted in the figure to the right. You can use these assets to define the contents and layout of the Rolling Calendar Page.
- Page Contents: this Bodycopy is used to define the overall layout of the Rolling Calendar Page.
- Time Unit Format: this Bodycopy is used to define the layout for each day in the Rolling Calendar Page.
- Single Calendar Event Format: this Bodycopy is used to define the layout for a Single Calendar Event and any single events on the Multi-Date Calendar Event.
- Recurring Event Format: this Bodycopy is used to define the layout for a Recurring Calendar Event and any recurring events on the Multi-Date Calendar Event.
For more information on these assets, refer to the sections below.
Details Screen
The Details screen allows you to configure the details of the Rolling Calendar Page. For more information on the Status, Future Status and Thumbnail section, refer to the Details Screen chapter in the Asset Screens manual.
Details
This section allows you to change the details of the page. The Details section of the Details screen is shown in the figure below.
The fields available are as follows:
- Name: by default, the information that was entered into the Name field when the page was created will appear in this field. To change the name of the page, click in the box and enter the new Name.
- Short Name: by default, the information that was entered into the Name field when the page was created will appear in this field. To change the short name of the page, click in the box and enter the new Short Name.
- Event Sources: by default, the sections that were select in the Event Sources field when the page was created will appear in this field. To change an Event Source, click the Change button. To add an additional Event Source, click the More button.
- Time Unit: select which time unit to use for the Rolling Calendar Page. These options include days, weeks, months. By default this is set to days.
- From: enter the start of the time frame to show on the Rolling Calendar Page. For example, if you want to show the events for the next seven days, enter 0 days in the future in this field. If you want to show events that have occurred, you can select in the past in the list provided. You can also change the time frame in the Time Unit field above. For example, if you select months in the Time Unit field, the time frame in this field will change to months.
- To: enter the end of the time frame to show on the Rolling Calendar Page. For example, if you want to show the events for the next seven days, enter 6 days in the future in this field. If you want to show events that have occurred, you can select in the past in the list provided. You can also change the time frame in the Time Unit field above. For example, if you select months in the Time Unit field, the time frame in this field will change to months.
- Day Filter: select which days to show on the page. By default, all days are selected.
Customise Bodycopies
This section allows you to enable the customisation of the No Results Bodycopy on the Rolling Calendar Page. The Customise Bodycopies section of the Details screen is shown in the figure below.
Enabling the Customise No Results Bodycopy? field will display the No Results Bodycopy in the Asset Map. This Bodycopy is used to define the layout of the Rolling Calendar Page when no events are found. By default, the Rolling Calendar Page will read No Results Found.
To change the layout of this page, either click on the No Results Bodycopy once this field is enabled, or right click on the bodycopy in the Asset Map and select Edit Contents. Click on the icon; the WYSIWYG Editor will appear where you can use keyword replacements and formatting to define the layout of the Rolling Calendar Page.
Page Contents Bodycopy
The Page Contents Bodycopy asset is used to define the overall layout of the Rolling Calendar Page including where to display the list of events and a heading for the page, as shown in the figure below.
To change what information is being shown, right click on the Page Contents Bodycopy in the Asset Map and select Edit Contents. Click on the icon; the WYSIWYG Editor will appear where you can use keyword replacements and formatting to layout the information to show on the page. By default, the keyword replacement %event_list% will appear in the WYSIWYG Editor by default.
Tip: If you do not include the keyword replacement List of Events on the Page Contents Bodycopy, the list of events will not appear.
Keyword Replacements on the Page Contents Bodycopy
A list of keyword replacements is provided in the WYSIWYG Editor toolbar on the Edit Contents screen of the Page Contents Bodycopy. You can use these keyword replacements in conjunction with text, images and links etc to layout what to show for the page. The keyword replacements that are available include the following:
- List of events: this will show the list of events on the page. If you do not include this keyword replacement, the list of events will not appear on the page.
Time Unit Format Bodycopy
The Time Format Bodycopy is used to define the layout for each day on the page. For example, for the Rolling Calendar Page shown in the figure above, the date and the events for that date are shown. This has been defined in the Time Unit Format Bodycopy.
To change what information is being shown, right click on the Time Unit Format Bodycopy in the Asset Map and select Edit Contents. Click on the icon; the WYSIWYG Editor will appear where you can use keyword replacements and formatting to layout the information to show on the page. By default, the keyword replacements %time_unit_start_datetime_Y-m-d% %time_unit_event_list% will appear in the WYSIWYG Editor by default.
Tip: If you do not include the keyword replacement List of Events for this Time Unit (days) on the Time Unit Format Bodycopy, the list of events will not appear.
Keyword Replacements on the Time Unit Format Bodycopy
A list of keyword replacements is provided in the WYSIWYG Editor toolbar on the Edit Contents screen of the Time Unit Format Bodycopy. You can use these keyword replacements in conjunction with text, images and links etc to layout the events for the page. For a full list of available keyword replacements, refer to the Time Unit Format Bodycopy section in the Restricted-Period Calendar Page chapter in this manual.
Single Calendar Event Format Bodycopy
The Single Calendar Event Format Bodycopy is used to define the layout for a Single Calendar Event and any single instance on the Multi-Date Calendar Event that are being shown on the page. To change what information is being shown, right click on the Single Calendar Event Format Bodycopy in the Asset Map and select Edit Contents. Click on the icon; the WYSIWYG Editor will appear where you can use keyword replacements and formatting to layout the information to show on the page. By default, the keyword replacements %asset_name% (%event_start_date%) will appear in the WYSIWYG Editor.
Keyword Replacements on the Single Calendar Event Format Bodycopy
A list of keyword replacements is provided in the WYSIWYG Editor toolbar on the Edit Contents screen of the Single Calendar Event Format Bodycopy. You can use these keyword replacement in conjunction with text, image and link etc to layout the events for the page. For a full list of available keyword replacements, refer to the Single Event Format Bodycopy section in the Calendar Page chapter in this manual.
Recurring Calendar Event Format Bodycopy
The Recurring Calendar Event Format Bodycopy is used to define the layout for a Recurring Calendar Event and any recurring instance on the Multi-Date Calendar Event that are being shown on the page. To change what information is being shown, right click on the Recurring Calendar Event Format Bodycopy in the Asset Map and select Edit Contents. Click on the icon; the WYSIWYG Editor will appear where you can use keyword replacements and formatting to layout the information to show on the page. By default, the keyword replacements %asset_name% (%event_start_date%) will appear in the WYSIWYG Editor.
Keyword Replacements on the Recurring Calendar Event Format Bodycopy
A list of keyword replacements is provided in the WYSIWYG Editor toolbar on the Edit Contents screen of the Recurring Calendar Event Bodycopy. You can use these keyword replacements in conjunction with text, images and links etc to layout the events for the page. For a full list of available keyword replacements, refer to the Recurring Event Format Bodycopy section in the Calendar Page chapter in this manual.