calendarize_news für TYPO3

Events in tx_news gehören in einen Kalender, nicht in eine chronologische Liste

Die meisten TYPO3-Websites nutzen Georg Ringers tx_news für alles: Nachrichten, Blog-Artikel, Pressemitteilungen und Events. Für die ersten drei Typen funktioniert die chronologische Listendarstellung. Für Events nicht. Besucher erwarten eine Kalenderansicht mit Monats-, Wochen- und Tagesdarstellung. Sie wollen auf ein Datum klicken und sehen, was an diesem Tag stattfindet. calendarize_news baut genau diese Brücke: Es nimmt bestehende News-Datensätze mit Datumsfeldern und rendert sie als Kalender.

Die Extension spart den Umstieg auf ein eigenständiges Event-System. Wer tx_news bereits im Einsatz hat, behält seine Datenstruktur, seine Templates und seine Redaktionsprozesse. Statt einer zweiten Extension mit separater Datenhaltung gibt es eine Kalender-View auf bestehende Daten.

Typische Einsatzszenarien

Veranstaltungskalender auf Unternehmenswebsites. Ein Bildungsträger veröffentlicht 150 Seminare pro Jahr über tx_news. Jedes Seminar hat ein Startdatum, ein Enddatum und eine Uhrzeit. Ohne calendarize_news sehen Besucher eine lange Liste, sortiert nach Datum. Mit calendarize_news sehen sie einen Monatskalender, klicken auf den 15. Mai und finden drei Seminare. Die Conversion von der Kalenderansicht zur Detailseite lag bei einem Kunden 40% höher als von der Listenansicht.

Wiederkehrende Events ohne Daten-Duplikation. Ein wöchentlicher Stammtisch, ein monatliches Webinar, ein jährliches Firmenfest: Ohne Recurrence-Funktionalität muss der Redakteur 52 Datensätze für den Stammtisch anlegen. calendarize_news unterstützt Wiederholungsregeln (täglich, wöchentlich, monatlich, jährlich) mit Ausnahmen. Ein Datensatz erzeugt 52 Kalendereinträge. Fällt ein Termin aus, wird er als Ausnahme markiert, nicht gelöscht.

Kombinierte News- und Event-Seiten. Viele Organisationen zeigen auf der Startseite “Aktuelles”, eine Mischung aus Nachrichten und anstehenden Events. calendarize_news ermöglicht es, dieselben Datensätze in der News-Liste chronologisch und im Kalender datumbasiert darzustellen. Zwei Views, eine Datenquelle, kein Synchronisationsaufwand.

Technische Architektur

calendarize_news ist ein Aufsatz auf die Kalender-Extension calendarize desselben Autors (Tim Lochmüller). Es hängt News-Datensätzen im Feld calendarize Termin-Konfigurationen an: Startdatum, Enddatum, Ganztags-Flag, Wiederholungsregel und Ausnahmen. Aus diesen Konfigurationen legt calendarize beim Speichern für jeden Einzeltermin einen Eintrag in seiner Index-Tabelle an.

Die Kalenderdarstellung erfolgt über Fluid-Templates, die ein Monats-Grid rendern. Jede Zelle (Tag) enthält die Events dieses Tages. Die Templates sind vollständig anpassbar. Standardmäßig liefert die Extension Templates für Monats-, Wochen- und Tagesansicht. Die Navigation zwischen Monaten erfolgt per AJAX oder klassischem Seitenaufruf, konfigurierbar per TypoScript.

Die Integration mit tx_news ist tief: calendarize_news meldet News als Ereignistyp bei calendarize an; die Kalenderansichten liefert das calendarize-Plugin, dem calendarize_news ein Feld für die News-Seite hinzufügt. Kategorien, Tags und Zugriffsbeschränkungen aus tx_news werden übernommen. Ein Event, das der Kategorie “Intern” zugeordnet ist und nur für eingeloggte Benutzer sichtbar sein soll, erscheint auch im Kalender nur nach Login.

Die iCal-Export-Funktion generiert .ics-Dateien für einzelne Events oder den gesamten Kalender. Besucher können Events direkt in Outlook, Apple Kalender oder Google Calendar importieren. Der Export nutzt das iCalendar-Format (RFC 5545) und berücksichtigt Wiederholungsregeln.

Häufige Probleme und Lösungen

Kalender zeigt keine Events, obwohl News vorhanden sind. Häufigste Ursache: Die Datumsfelder der News-Datensätze sind nicht befüllt. tx_news hat ein datetime-Feld, aber die Termine stehen in calendarize-Konfigurationen, die bestehenden News-Datensätzen im Feld calendarize erst hinzugefügt werden müssen. Lösung: Ein Migrations-Script, das aus datetime je News-Datensatz eine calendarize-Konfiguration anlegt, dauert 30 Minuten Entwicklungszeit.

Performance-Probleme bei vielen wiederkehrenden Events. Wenn 50 wiederkehrende Events jeweils 52 Einzeltermine erzeugen, stehen 2.600 Einträge im Kalender-Index, die die Monatsansicht filtern muss. Das ist bei jedem uncached Seitenaufruf spürbar. Lösung: Die Listen- und Monatsansicht gecacht ausliefern, wie calendarize es von Haus aus tut, und die Zeitspanne begrenzen, für die calendarize Termine in den Index schreibt (Einstellung tillDays). Events, die mehr als 12 Monate in der Zukunft liegen, müssen nicht im Index stehen.

Responsive Darstellung des Kalender-Grids. Ein 7-Spalten-Grid für Wochentage funktioniert auf Desktop, aber nicht auf Smartphones. Die Standard-Templates von calendarize_news sind nicht mobil-optimiert. Lösung: Die Fluid-Templates anpassen und auf mobilen Geräten eine Listen-Darstellung statt des Grids rendern. Ein CSS-Breakpoint bei 768px reicht aus, um zwischen Grid und Liste zu wechseln.

Migration und Versions-Kompatibilität

calendarize_news hängt von tx_news und calendarize ab. Die aktuelle Version 9.0.0 setzt TYPO3 13.4, tx_news ab Version 12 und calendarize 13 oder 14 voraus; für TYPO3 v12 gibt es Version 8.0.1.

calendarize (ohne _news-Suffix) von lochmueller ist eine eigenständige Kalender-Extension mit eigenem Datenmodell und zugleich die Basis, auf der calendarize_news aufsetzt: Die Termine der News liegen bereits in den calendarize-Tabellen. Die aktuelle Version 15 unterstützt TYPO3 13.4 und 14.

Für Projekte, die auf TYPO3 v13 migrieren und tx_news behalten wollen, ist der pragmatischste Weg: calendarize_news in Version 9 einsetzen oder die Kalenderdarstellung als Custom Fluid-Template direkt in tx_news bauen. Der Aufwand für ein Custom-Template liegt bei 2-3 Tagen, das Ergebnis ist unabhängig von Drittanbieter-Pflege. Gosign hat beide Wege umgesetzt und empfiehlt je nach Komplexität der Wiederholungsregeln die passende Variante.