Calendar appointments are not tied to a single website, but can also be displayed on different websites. Appointment management is therefore independent of where the appointments are to be displayed later.

1. You create a system folder as a storage location for the appointments of an individual organisation, which can be created in a similar way to a normal standard page. It makes sense to give the folder a meaningful name, e.g. "Termine Institut Physik" or similar. - This name is only visible internally and allows you to quickly identify the appointment location by name.
2. After clicking on the newly created folder, a first appointment is created in it. (This is important so that the appointment pool is recognised as such by the Calendarize view). To do this, you can click on the blue "Go to list module" button. Use the plus symbol, which is located in the light grey area at the top of the list view directly below the black TYPO3 header bar, to create a new element and select Calendarize - Event Management → Event. A new window opens.
3. First enter a title there. Then switch to the"Date options" tab and click on "Create new" under "Calendarise". All you need to do here is click once in the white field under "Start date" so that the current date appears there. You can then click "Save and close" at the top to provisionally finalise the entry. - The appointment pool is now ready.

- in progress -

- in progress -

In the left-hand function column of TYPO3 there is the entry Web→Calendarize. This view is divided into three parts:

• Setting options for filtering and sorting
• Blue buttons for creating new appointments in a respective appointment pool
• List of existing calendar appointments.

Appointments can be created, edited and deleted here. A distinction must be made here between events and appointments.

Events vs. appointments

Each event can consist of one or more appointments. For example, a training seminar can take place on several days, but it is still an event with a description text. This event then includes several dates. This also applies to office hours that take place regularly in the same way - a new event does not have to be created for each appointment.

All existing appointments are listed in the Calendarise view, i.e. several appointments for recurring events. If you click on one of these appointments, you will be taken to the editing screen for the corresponding event where you can edit the event as such as well as all associated appointments.

Configuring the Calendarise view

The appointment list can be filtered and sorted. It can be sorted chronologically in ascending or descending order. Filtering can be based on entry type and storage location.

• Page/system folder: If you have access to several appointment pools, all appointments from all pools are listed at the bottom of the appointment list. However, if you only want to see the appointments from a single appointment pool, select the desired appointment pool here.
  Additional note: It is not important which page is clicked in the page tree, as the Calendarize view always shows all appointments to which you have access. The restriction to only one appointment pool is then made here under Page/System folder.
• Type: There are different entry types. In addition to "normal" calendar entries(events), these can also be pages, news items or appointment groups. If there are many entries, this selection can possibly increase the overview.
• Sorting: The order is always chronological. However, you can choose whether the earlier or later events should be displayed first. (In particular, if there are also many past appointments that may still be displayed in an archive, it is advisable to display the later appointments first ).

After you have changed these settings, save them using the Save button. TYPO3 then remembers these settings permanently.

Create new event

The blue buttons show the date pools to which you have access.

⇒ Now click on the button for the date pool in which you want to create a new event.

Edit an existing event

Existing events are listed below. Click on the title of an event or at the very end on the corresponding pencil icon to edit the event in question.

An event initially has these important text fields:

• Title: This is displayed as a heading both in overview lists and in the detailed view.
• Summary: This short text is displayed in overview lists in addition to the title, but not in the detailed view.
• Description: This field contains the full description text of the event and is only displayed in the detailed view. The field can contain formatted text, links etc.

The details of organisers and venues are entered in separate fields below:

• Venue from addresses: An address data record that has been generated separately can be selected here. The advantage of this is that much more specific data can be entered here. In addition, several venues can also be selected here and can then be clicked on separately!
• Alternatively: Venue: Pure text description of the venue together with venue link (this allows the venue to be made clickable in order to link to a site plan or similar)
• Organiser from addresses or alternatively organiser and organiser link: Works identically to the event location

Note: Organisers and venues are both address data records, but an institution or person is entered in one and a building or room in the other.

If different types of events are used in different contexts and are to appear on different websites for different target groups, for example, they can be categorised so that the output can then be filtered using the categories.

If required, new categories can be defined in addition to those already available in our TYPO3 system. This can be done, for example, in a separate system folder that is created specifically as a location for the categories. New categories can then be created in the list view and subordinated to an existing category. One or more of these categories can then be assigned to the individual events in the "Categories" tab.

If you also offer your websites in English, you may also want to do this with the calendar entries. Just as with websites, a calendar entry can also be given an English language version:

• Prerequisite: An English version of the appointment pool (system folder containing the appointments) must first exist. To do this, click on it in the page tree and switch to the list view. The option to create an (English) translation of the folder is then offered at the top. If necessary, please enter an English folder name here and then save it.
• Creating a language version of an event: Then switch back to the Calendarise view (green symbol in the left-hand TYPO3 column) and open an event that was previously only available in German for editing. At the top (still above the Save button) you will now find a language selection where you can create an English language version of the event.
• Edit the text fields of the language version: You can now fill the texts of the English language version with English-language content. The date options, however, cannot be changed here as they are automatically taken from the original German-language version of the event.

Starting point (in the "Plug-in" tab → "General configuration" sub-tab)

At least one appointment pool (system folder containing appointments) must be selected here, from which the appointments for the listing are then taken.

Filtering by category (in the "Categories" tab)

If one or more categories are assigned to the calendar content element, this means that only those appointments are displayed that have at least one of the categories selected here.

Filtering by data types: Events, websites, news items (in the "Plug-in" tab → "Main configuration" sub-tab)

In the "Data type" list, you can tick which types of calendar entries should be displayed: Events (Event), calendarised websites and/or news (News).

For websites, it is important that a suitable starting point (see above) is defined, i.e. a higher-level page containing the calendarised pages.

(The documentation for the additional "Groups" element is still in progress).

Quantity restriction: Limit (in the "Plug-in" tab → "Main configuration" sub-tab)

The maximum number of appointments to be displayed can be set here.

Overwrite start date / Overwrite end date (in the "Plug-in" tab → "Main configuration" sub-tab)

Normally, the next appointments are automatically displayed or automatically hidden again once the appointment has been reached. However, it may be desired to display only the dates of a specific period (e.g. a past period for an event archive or a future period à la "Event programme for the year 2022".

Absolute points in time can be defined as the start or end date (e.g. 1 January at 0:00 and 31 December at 23:59 for a specific year) or relative periods (e.g. "- 20 years" and "now" for the entire past 20 years - to do this, first set the "Use relative date" switch).

Aesthetics of the calendar overview

By default, the calendar entries in the overview appear as a horizontally scrollable element on the website. Depending on the application, however, a different form of presentation may be desired. Here are a few keywords for the configuration options:

• Instead of a dynamic scrolling look, a static two-column display can also be selected. The appointments are stacked one below the other and are therefore also visible without scrolling.
• You can differentiate within the static display, so you can also select a compact display that requires less space.
• Certain elements within the listed appointments can be hidden, e.g. the text (from the "Summary" field), the "more" button or (if available) the categories of the appointment. This results in an even more compact display.

Customise the appearance of the appointment list

The static two-column look is activated by entering the following in the [Advanced] tab of the calendar content element in the CSS class for content element the character string kal-archiv.

This look can be changed even further by entering additional information (separated by spaces) in the field:

• kal-compact results in an even more compact display, in which the time information appears on the left and the content text on the right. The font size of the event title is reduced slightly.
• kal-ohnemehr hides the more button
• kal-ohnetext hides the description text so that only the title remains
• kal-ohnekats hides the categories (if any are assigned to the event entry)
• kal-ohnezeit hides the time information

Example: kal-archiv kal-ohnemehr kal-ohnekats displays the appointments in two columns and hides the more buttons and categories

Sorting (in the "Plug-in" tab → "General configuration" sub-tab)

The order of the appointments can be chronologically ascending. Typical applications:

• ASC (ASCending = ascending): In a "normal" calendar , the earlier appointments are displayed first. Those further in the future are then displayed further back.
• DESC (DESCending = descending): With a calendar archive, it may be desirable to display the later appointments first. Dates that are further in the past are then displayed further back, while the recently expired dates are displayed at the front.

Hide pagination and teaser (in the "Plug-in" tab → "Main configuration" sub-tab)

For a longer appointment list (e.g. an appointment archive spanning several years), pagination enables page-by-page scrolling. Only a limited number of appointments are then displayed. This pagination function can be deactivated.

As mentioned above, individual web pages can be assigned calendar dates directly and then automatically listed in date overviews.

It would now be helpful if the dates assigned to the page were also automatically displayed in the page in a readable format so that they do not have to be maintained manually in the text content of the page in addition to the date options.

This can be achieved by assigning the CSS class calendarisedPage to a content element on the page. This means that the remaining dates are automatically listed directly after the element that has been assigned this CSS class.
TIP: If you also assign the CSS class uhr, the individual dates are displayed with a clock symbol instead of a dash.

Note: The procedure is demonstrated in the training video above

If required, real-time filtering based on the category of events can be activated in the form of buttons located above the event list to display only the events in the announced category.

An example of such a solution can be viewed here:

uol.de/io/veranstaltungskalender

Please contact me if you have any questions.

Imagine this situation:

• An information event always takes place identically, and dates are always offered for it.
• The website for the event contains a registration form which can be used to register for participation.
• The form should now automatically offer all future dates already planned for selection, from which you can then choose a date.

Note: The procedure for achieving this is explained in the training video above.