Series 6: Extensions Chapter 1 of 10

Events: dates, locations and recurrence

Editing content
Applies to: Extension “Events” As of Sulu 3.0

This only exists with the extension “Events”. If it is missing from your administration, the extension is not installed.

In short

Under Events you maintain dates, under Locations the addresses. In the tab Recurrence you let an event repeat. The Settings decide how events appear on the website.

The extension Events manages dates with day, place and text. It suits open days, trade fairs and talks. Visitors see the dates as a list on the website.

How to enter a single event is described in “Adding an event”. This article is about the rest: locations, recurrence and settings. At the end you find how developers install the extension.

Helpful first: 2.5 Adding an event

Step 1 of 7 The menu Events

The main menu has the entry Events with three sub-items:

  1. Events: the list of all events.
  2. Locations: the addresses from which you choose for an event.
  3. Settings: how the events appear on the website.
  4. An event in the list: a click opens it.

If the entry is missing, the extension is not set up or your role has no permission for it. Then ask the person who manages the users at your business, or your agency.

Step 2 of 7 Create a location

Click Locations and then Add. A location has these details:

  1. Name: how the location appears with an event. The name is required.
  2. Street, Number, ZIP, City, Region and Country: the postal address.
  3. Location: the position on the map.

The tabs Contact details and Premises take further details. Click Save. For each event you then choose the location in the field Location. A location can be used for any number of events.

Step 3 of 7 Repeat an event

Open an event and click the tab Recurrence. Turn on Recurring Event. Three details appear below it:

  • Repeat Pattern: Daily, Weekly, Monthly or Yearly.
  • Every X (days/weeks/months): how often the event repeats. With “2” and weekly it is every second week.
  • Ends: Never, After Count or Until Date.

Click Save. How the repetitions appear on the website depends on your website. The calendar frontend is part of the installation, see below.

Step 4 of 7 Set up the display on the website

Under Events › Settings there are three tabs. Click Save after changes.

  • General: in the area Settings for Single View you turn header, default hero, breadcrumbs, tags and categories on or off on the page of an event. In the area List View, Link RSS feed, Link Atom feed and Offer iCal file control the feeds and the calendar download of the event list.
  • Calendar: details for the calendar of the website, for example Week Start, Week Numbers and Show Time.
  • Breadcrumbs: the pages that appear before an event in the breadcrumb navigation. There are Overview All Events, Overview pending Events and Overview expired Events.

Step 5 of 7 The event list on the website

Visitors see the events as cards with image, title, date and short text. The example shows the page Events.

Step 6 of 7 The page of an event

A click on a card opens the page of the event: image, title, subtitle, date, summary and text. Below it comes the address of the location.

Step 7 of 7 Installing it in your project

The extension is called SuluEventBundle. On Packagist it is at version 3.5.3 (as of November 2026). It needs Sulu 3 and PHP 8.2 or newer.

  1. Install the package with the command below.
  2. Enter the admin routes in routes_admin.yaml. For calendar, iCal file and feeds, the website routes go into routes_website.yaml.
  3. Update the database.
  4. In the user roles, assign the permissions for “Events” and “Locations”.

The exact lines and all settings are in the README of the bundle on GitHub. The folder docs explains the calendar, recurring events, feeds and iCal, smart content and locations.

Installation
composer require manuxi/sulu-event-bundle

More on this