Im Oktober 2025 war das SuluEventBundle eine Eventverwaltung mit Papierkorb, Zeitsteuerung und Smart Content (siehe Ein eigener Inhaltstyp, der sich wie Sulu anfühlt). Es fehlte etwas, das Besucher sofort verstehen: ein Kalender. Am 30. Oktober habe ich damit angefangen, neun Tage später, am 7. November, lief er lokalisiert und auch mit mehreren Kalendern auf einer Seite. Das alles geschah noch unter Sulu 2.
Davor hatte ich im Oktober aufgeräumt. Der Zustand „aktiv“ eines Events wurde durch einen Veröffentlichungsstatus mit Zeitpunkt ersetzt (11. Oktober), und die Admin-Suche findet seit dem 13. Oktober auch Entwürfe. Am 16. Oktober band ich außerdem SuluSharedTools ein, das gemeinsame Bundle meiner Sulu-2-Bundles. Es sollte dem Kalender ein paar Wochen später noch einen Umweg bescheren (dazu unten mehr).
Ein Commit, viele Funktionen
Der erste Kalender-Commit vom 30. Oktober umfasst 31 Dateien und gut 2.000 Zeilen. Darin steckt mehr als ein Kalender, nämlich alles, was dazugehört, wenn Termine auf der Website nützlich sein sollen:
- eine API, die Events für einen angefragten Zeitraum liefert
- das Frontend auf Basis von FullCalendar
- ein Inhaltstyp, mit dem sich der Kalender auf Seiten einbinden lässt
- wiederkehrende Veranstaltungen
- iCal-Export
- RSS- und Atom-Feeds
- Einstellungen zum Teilen in sozialen Netzwerken pro Event
- eine Begrenzung der Anfragen an die Kalender-API
Die nächsten Tage galten dem Feinschliff.
Der Kalender
Der Kalender zeigt Monat, Woche, Jahr sowie eine Wochen- und eine Monatsliste. Welche Ansichten Besucher sehen und ob sie zwischen ihnen wechseln dürfen, stellt man im Admin ein. Dort lassen sich auch Wochenstart, Wochennummern, Wochenenden, die Zahl der Events pro Tag, die Uhrzeit, Typ und Ort im Popover, die Standardfarbe sowie das Zeitfenster der Wochenansicht festlegen. In der Jahresansicht bestimmt man, wie viele Monate nebeneinander stehen.
Ein Event gilt als ganztägig, wenn es um 00:00 Uhr beginnt und um 00:00 Uhr endet oder gar kein Ende hat. Dann zeigt der Kalender keine Uhrzeit an. Die Kalender-API nimmt pro IP-Adresse höchstens 100 Anfragen pro Stunde an, der Wert lässt sich in der Symfony-Konfiguration ändern. Am 6. November kam hinzu, dass mehrere Kalender auf einer Seite funktionieren.
Bei der Installation bin ich in der Doku ehrlich: Sie sei „nicht ganz ohne“. FullCalendar kommt per npm in das Projekt, dazu sind Anpassungen an der Webpack-Konfiguration nötig.
Event-Typen mit Farben
Jedes Event hat einen Typ, und jeder Typ hat einen Namen und eine Farbe. Der Kalender färbt die Einträge danach, im Formular zeigt die Auswahl die Farbe mit an. Das Bundle bringt zehn Typen mit. Wer eigene definieren will, tut das in der Konfiguration des Projekts. Eigene Typen ersetzen die des Bundles vollständig, sie werden nicht zusammengeführt. Das ist Absicht.
Wiederkehrende Veranstaltungen: berechnen oder speichern
Ein Event kann sich täglich, wöchentlich, monatlich oder jährlich wiederholen, in einem festen Abstand und an bestimmten Wochentagen. Das Ende legt man fest als „nie“, „nach Anzahl“ oder „bis Datum“.
Technisch gibt es zwei Wege, aus der Regel konkrete Termine zu machen. Beim ersten werden Vorkommen berechnet, wenn jemand einen Zeitraum abfragt, etwa im Kalender. Sie existieren nur im Moment der Anfrage. Beim zweiten legt ein Konsolenkommando echte Einträge an, standardmäßig für die nächsten 90 Tage. Es ist für einen Cronjob gedacht. Die gespeicherten Einträge sind gewöhnliche Events. Laut Doku hilft das bei Performance und Indizierung.
Beide Wege gibt es nebeneinander, das Bundle legt sich nicht auf einen fest.
iCal und Feeds
Besucher können einzelne Events als .ics-Datei herunterladen oder den gesamten Kalender abonnieren, auch per webcal://. Für neue Events gibt es RSS- und Atom-Feeds pro Sprache. Die Adressen sind einfach aufgebaut: /events/calendar.de.ics für das Abonnement und /events/feed.de.atom für den Feed.
Wenn die Optimierung an der falschen Stelle sitzt
Am 4. November habe ich das Bundle auf Performance getrimmt. SEO, Excerpt und die Social-Einstellungen eines Events wurden per Eager Loading gleich mitgeladen, die Übersetzungen nicht mehr „extra lazy“. In der Nacht zum 5. November nahm ich die Änderung wieder zurück. Im Commit steht der Grund: Die Geschwindigkeit hatte nicht mein Code gebremst, sondern ein Fehler in SuluSharedTools.
Welcher Fehler das genau war, sagt der Commit nicht. Wenige Minuten vorher hatte ich in SuluSharedTools allerdings eine Methode korrigiert, die die Kategorienamen eines Excerpts sammelt: Sie gab statt des Namens das ganze Übersetzungsobjekt der Kategorie zurück. Mein Eager Loading hatte also an einer Stelle gedreht, an der das Problem gar nicht lag.
Im Nachhinein ist die Reihenfolge klar: erst herausfinden, wo die Zeit bleibt, dann optimieren. Und ein gemeinsames Bundle hat eine Seite, die man gern vergisst. Es spart Code, aber ein Fehler darin wirkt in allen Bundles zugleich, und man sucht ihn zuerst im eigenen. Unter Sulu 3 habe ich SuluSharedTools nicht mehr gebraucht (Der Umbau auf Sulu 3).
Danach
Am 5. November erschien Version 2.0.0. Die Sulu-2-Linie bekam danach noch kleine Korrekturen bis zum 12. November, 2.0.6 folgte im April 2026. Ende November begann der Umbau auf Sulu 3. Davon handelt der nächste Beitrag.
Repository: manuxi/SuluEventBundle auf GitHub, mit Doku zu Kalender, Wiederholungen und Feeds und iCal.