Configuration

In order to use this extension, you must configure which places of worship you intend to use. This is done by editing your site configuration (stored in config/sites/<site>/config.yaml), and adding a list of theodia calendars.

The easiest way to do this is to use the site configuration editor in the Backend, which will automatically add the correct configuration for you. To do so, go to the Backend and then:

  • Open Site Management > Sites

  • Find the site you want to configure and click the pencil icon to edit it

  • Go to the "theodia" tab

  • Add a mapping for each calendar you want to use in this site.

Configuration of calendars to use

Each calendar you want to use is of the form <id>, <name> where <id> is the ID of the calendar in theodia.

A sample configuration could be:

148, Église Sts Pierre-et-Paul, Marly
150, Église de Praroman, Le Mouret

You can find the ID of a calendar by searching it on https://theodia.org/en/widget, selecting it in the list, and looking at the generated code snippet.

This mapping is used to generate the list of available calendars to be used with the plugin:

List of calendars to show in a given plugin

Configuration in TypoScript

You should also configure the extension in TypoScript. You can do so like that:

  1. Open the Template module within the Web section.

  2. Select your root page template (usually the one with the world icon).

  3. Make sure you are on the "Info/Modify" view (top selector).

  4. Click on the button "Edit the whole template record".

  5. Switch to tab "Includes".

  6. Include "theodia (theodia)" within the "Include static (from extensions)" section.

Alternatively if you are using a Site package, you can add the following to your Configuration/TypoScript/constants.typoscript file (or alike):

@import 'EXT:theodia/Configuration/TypoScript/constants.typoscript'

and in your Configuration/TypoScript/setup.typoscript file (or alike):

@import 'EXT:theodia/Configuration/TypoScript/setup.typoscript'

then adapt the configuration to your needs (you may use the built-in Constant Editor to guide you).

Constants

Any constant needs to be prefixed with plugin.tx_theodia.settings..

eventDateFormat

eventDateFormat
Type

string

Default

%A %e %B %Y

Path

plugin.tx_theodia.settings

Format of the dates in the event list. The default value will show, e.g., Monday 25 December 2023 (localized to the language you use).

Format of the string is either a strftime() format string (localized) or a date() format string (English/numeric only).

eventTimeFormat

eventTimeFormat
Type

string

Default

H:i

Path

plugin.tx_theodia.settings

Format of the times in the event list. Typically use H:i for 24h format (e.g. 08:30 or 17:00) or g:i a for 12h format (e.g., 8:30 AM or 5:00 PM).

cssIframe

cssIframe
Type

string

Default

EXT:theodia/Resources/Public/Css/iframe.css

Path

plugin.tx_theodia.settings

Path to a custom CSS when using an iframe to list events.