Calendar content
This page describes the specific process for integrating calendar content from external iCalendar feeds (.ics files) into a TYPO3 website using the CurlContent extension.
The events are displayed as a list, sorted by their start date.
Preparation: Have the iCalendar feed URL ready
Make sure you have the full URL of the desired iCalendar feed (.ics) available, for example, the URL of a calendar from the myTUM portal. You will need this URL in the next step when integrating the plugin.
Embedding calendar content - step by step
- Open the Page module and select the target page.
- Click “+ Content” → under “Special” choose “Insert Plugin”.
- In the “Plugin” field, select “CurlContent”.
- On the “Data source” tab, select “Custom URL” under “URL preset”.
- Under “Parameters for preset”, enter the full iCalendar feed URL.
- On the “Processing” tab, select “Convert iCalendar data (iCal, .ics) into XML (xCal) [IcalToXcal]” under “Filtering or conversion”.
- Then, under “XSL File”, select “Events as list”.
- Save the content element.
Note
If recurring events are included in the .ics calendar, the entire series will not be imported. Only the first occurrence of the recurring event will be displayed.
Additional options: XSL parameter
The following parameters are available in the "Parameters for this XSL file" field:
| Parameter | Description | Default | Example |
|---|---|---|---|
maxdays | Maximum number of days from today for which events are displayed | 10 | maxdays=30 |
past | Also display past events | Off | past |
fold | Display event details in a collapsible accordion | Off | fold |
Update caching
As with all CurlContent applications, the data is automatically refreshed from the feed every 10 days by default.
To force an immediate update, use the lightning bolt icon (“Clear cache for this page”). This clears the page cache and immediately retrieves the latest publication data from mediaTUM.
English version
The CurlContent element must also be translated for the English page, just like any other content element.
- In the Page module, switch to the Languages view.
- Click “Translate” for the CurlContent element.
- The English copy automatically inherits the feed URL and parameters. There is nothing else to translate here unless the calendar itself contains content that requires translation.
- Enable the English element (turn its visibility on).