Configuration¶

This plugin builds its configuration from Project config, managed via the Eventful → Settings screen in Craft’s control panel.

Event properties¶

Once you add an Event Date field to something, you'll likely want to define other properties that should also show in the calendar, in ICS files, etc.

You can customize how event titles, descriptions, and locations are rendered by modifying the relevant object templates. The templates are passed the element object, and an ics variable that is true when rendering in an ICS file.

In ICS files, any HTML is converted to plain text, keeping paragraphs, line breaks, list items and links. Text without any HTML tags is kept as is. So a template should output either plain text or HTML: if it includes any HTML (e.g. a rich text field), write the rest of it as HTML too, using <p> or <br> for line breaks.

Time zone picker¶

Event Date fields list time zones by city and country (e.g. "Toronto, Canada"), sorted alphabetically, with the time zone's abbreviation or offset on the event's date (e.g. "EST" or "GMT+1"). You can also search them by country, name (e.g. "Eastern Time") or offset (e.g. "UTC-5").

By default, Craft's own time zone inputs (e.g. in user preferences, general settings and Date fields) list time zones in the same way. To keep Craft's list instead, turn off Use the time zone picker everywhere.

Public calendar¶

If you want to have a public iCalendar format URL, you can configure a calendar secret, which will be used to generate a URL like https://example.com/admin/secret.ics.

Extra event sources¶

You can configure extra event sources to display readonly on the calendar. The URLs are object templates passed a year variable, so you can configure URLs like https://canada-holidays.ca/ics/{year}.

Calendar filters¶

Organizer (Craft Team / Pro)¶

You can optionally enable the ability to filter the calendar by organizer.

By default this will list all users and filter events by their authorId, but you can customize the filter label, user group, and organizer field handle. To further customize which users are listed, use the define organizer query event.