calendarize_news for 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.

Typical use cases

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.

Technical architecture

calendarize_news erweitert tx_news um zusätzliche Datenbankfelder in der Tabelle tx_news_domain_model_news: Startdatum, Enddatum, Ganztags-Flag, Wiederholungsregel und Ausnahme-Daten. Die Wiederholungslogik ist in der Extension implementiert und generiert virtuelle Termine zur Laufzeit, ohne für jeden Einzeltermin einen Datensatz in der Datenbank anzulegen.

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 registriert sich als zusätzliches Plugin (list type) und nutzt tx_news’ Repository-Pattern. 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.

Common problems and solutions

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 calendarize_news nutzt eigene Felder für Start- und Enddatum. Nach der Installation müssen bestehende News-Datensätze um die calendarize-Felder ergänzt werden. Lösung: Ein Migrations-Script, das datetime in die calendarize-Felder kopiert, dauert 30 Minuten Entwicklungszeit.

Performance-Probleme bei vielen wiederkehrenden Events. Wenn 50 wiederkehrende Events jeweils 52 virtuelle Termine erzeugen, muss die Extension 2.600 Einträge für die Monatsansicht filtern. Das ist bei jedem uncached Seitenaufruf spürbar. Lösung: Die Recurrence-Berechnung cachen (calendarize_news unterstützt TYPO3s Caching Framework) und die Zeitspanne begrenzen. Events, die mehr als 12 Monate in der Zukunft liegen, müssen nicht bei jedem Request berechnet werden.

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 and version compatibility

calendarize_news hängt direkt von tx_news ab und folgt dessen Versions-Zyklus mit Verzögerung. Die aktuelle stabile Version unterstützt TYPO3 v11 und v12 mit tx_news v10/v11. Für TYPO3 v13 existiert eine Beta-Version auf GitHub.

Die Alternative calendarize (ohne _news-Suffix) von lochmueller ist eine eigenständige Kalender-Extension, die nicht auf tx_news aufbaut, sondern ein eigenes Datenmodell mitbringt. Sie wird aktiver gepflegt und unterstützt TYPO3 v12 und v13 offiziell. Der Umstieg von calendarize_news auf calendarize erfordert eine Datenmigration: Die Event-Daten müssen aus der tx_news-Tabelle in die calendarize-Tabellen überführt werden.

Für Projekte, die auf TYPO3 v13 migrieren und tx_news behalten wollen, ist der pragmatischste Weg: die calendarize_news-Beta 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.