Öffnungszeiten für TYPO3

Besucher wollen wissen, ob eine Einrichtung gerade geöffnet hat, nicht die regulären Zeiten nachschlagen

Die häufigste Frage, die Besucher auf der Website einer Bibliothek, eines Museums oder einer Behörde haben, ist simpel: Haben Sie gerade offen? Trotzdem zeigen die meisten TYPO3-Websites eine statische Tabelle mit den regulären Öffnungszeiten, die an Feiertagen, Brückentagen und Sonderschließungen falsch ist. Die Lösung ist eine Öffnungszeiten-Verwaltung, die reguläre Öffnungszeiten, Feiertage und Sonderöffnungszeiten in einer einzigen Datenstruktur führt und im Frontend den aktuellen Status anzeigt: Geöffnet (grün) oder Geschlossen (rot), inklusive der nächsten Öffnungszeit. slub_web_openhours stammt dem Namen nach von der SLUB Dresden (Sächsische Landesbibliothek, Staats- und Universitätsbibliothek), ist aber weder im TER noch auf Packagist oder in den öffentlichen GitHub-Repositories der SLUB veröffentlicht; ihr Funktionsumfang lässt sich deshalb nicht prüfen.

Typische Einsatzszenarien betreffen Bibliotheken, Museen und kommunale Einrichtungen

Das primäre Szenario sind Hochschulbibliotheken mit mehreren Standorten. Die SLUB Dresden betreibt mehrere Standorte mit unterschiedlichen Öffnungszeiten. Der Hauptstandort hat andere Zeiten als die Zweigbibliothek, und während der Semesterferien gelten verkürzte Öffnungszeiten. Eine Öffnungszeiten-Verwaltung führt jeden Standort als eigenen Datensatz mit eigenen Zeiten. Auf der Website sieht ein Student sofort, welcher Standort gerade geöffnet ist und bis wann.

Ein zweites Szenario sind Museen und Galerien. Ein Kunstmuseum hat reguläre Öffnungszeiten (Di-So 10-18 Uhr, Mo geschlossen), aber verlängerte Öffnungszeiten während einer Sonderausstellung (täglich bis 21 Uhr) und Schließungen an Feiertagen. Sinnvoll ist, diese Ausnahmen für definierte Zeiträume zu hinterlegen, ohne die regulären Zeiten zu ändern. Nach Ablauf des Sonderzeitraums gelten dann automatisch wieder die Standardzeiten.

Drittes Szenario: Kommunale Einrichtungen wie Bürgerbüros, Schwimmbäder und Jugendzentren. Eine Stadt mit 20 öffentlichen Einrichtungen pflegt die Öffnungszeiten zentral im TYPO3-Backend. Auf jeder Einrichtungsseite zeigt ein Widget den aktuellen Status. Im Sommer gelten für das Freibad andere Zeiten als im Winter, und an Brückentagen ist das Bürgerbüro geschlossen. All das muss die Öffnungszeiten-Verwaltung abbilden.

Technische Architektur speichert Regeln und Ausnahmen in einer kalendarischen Datenstruktur

Eine solche Verwaltung braucht drei Datenebenen: reguläre Zeiten (Montag bis Sonntag, Stunde:Minute bis Stunde:Minute), periodische Ausnahmen (Feiertage, die jährlich wiederkehren) und einmalige Ausnahmen (Sonderschließung am 15. März, verlängerte Öffnung am 24. Dezember). Reguläre Zeiten bilden die Basis, Ausnahmen überschreiben sie. Die Logik ist einfach: Gibt es für das aktuelle Datum eine Ausnahme? Wenn ja, gelten die Ausnahme-Zeiten. Wenn nein, gelten die regulären Zeiten für den aktuellen Wochentag.

Ein Frontend-Plugin rendert den Status über Fluid-Templates. Der aktuelle Zustand (offen/geschlossen) wird serverseitig berechnet und als CSS-Klasse ausgegeben, sodass die Farbgebung per Tailwind oder Custom CSS steuerbar ist. Optional zeigt das Widget die nächste Öffnungszeit an: “Aktuell geschlossen. Nächste Öffnung: Montag, 08:00 Uhr.”

Für die Schema.org-Integration lassen sich die Zeiten als OpeningHoursSpecification in JSON-LD ausgeben und Google so mitteilen, eine Anzeige garantiert Google aber nicht. Einrichtungen, die in Google Maps korrekte Öffnungszeiten zeigen wollen, pflegen sie deshalb zusätzlich direkt in ihrem Google-Unternehmensprofil, einschließlich Sonderöffnungszeiten.

Häufige Probleme betreffen Zeitzonen, fehlende Feiertage und Caching

Das häufigste Problem ist das Caching. Wenn TYPO3 die Seite cached und der Cache erst nach zwei Stunden abläuft, zeigt das Widget bis zu zwei Stunden lang den falschen Status. Die Lösung: Das Öffnungszeiten-Widget per USER_INT als uncached Plugin einbinden. Das kostet minimal Performance (eine Datenbankabfrage pro Request), garantiert aber korrekten Status.

Zweites Problem: Fehlende Feiertage. Eine vorkonfigurierte Feiertagsliste bringt TYPO3 nicht mit. Jede Einrichtung muss ihre Feiertage manuell eintragen oder über einen Import befüllen. Für bundeslandspezifische Feiertage (Fronleichnam gilt in Bayern, nicht in Berlin) ist manuelle Pflege oder ein Skript nötig, das Feiertage aus einer API (z.B. feiertage-api.de) importiert.

Drittes Thema: Zeitzonen bei internationalen Einrichtungen. Eine Berechnung auf dem Server arbeitet mit der Server-Zeitzone. Wenn der TYPO3-Server in UTC läuft, aber die Einrichtung in MEZ, stimmen die angezeigten Zeiten nicht. Die Lösung: Die PHP-Zeitzone in der TYPO3-Konfiguration auf die Zeitzone der Einrichtung setzen, oder bei Einrichtungen in mehreren Zeitzonen die Berechnung per UTC+Offset im Fluid-Template anpassen.

slub_web_openhours ist nicht öffentlich verfügbar

slub_web_openhours ist weder im TER noch auf Packagist veröffentlicht, und unter den öffentlichen GitHub-Repositories der SLUB Dresden findet sich die Extension nicht. Welche TYPO3-Versionen sie unterstützt, lässt sich deshalb nicht prüfen. Gosign empfiehlt bei Öffnungszeiten-Projekten, die Schema.org-Ausgabe mit Googles Testtools zu prüfen und die Öffnungszeiten parallel im Google-Unternehmensprofil zu pflegen, damit sie in Google Maps und im Unternehmensprofil der Suche korrekt erscheinen.