Godziny otwarcia dla TYPO3

Odwiedzający chcą wiedzieć, czy instytucja jest właśnie otwarta, a nie sprawdzać regulaminowe godziny

Najczęstszym pytaniem, jakie odwiedzający zadają na stronie biblioteki, muzeum lub urzędu, jest proste: czy jesteście teraz otwarci? Mimo to większość witryn TYPO3 pokazuje statyczną tabelę regularnych godzin otwarcia, która w święta, dni okołoświąteczne i dni okolicznościowych zamknięć jest po prostu błędna. slub_web_openhours rozwiązuje dokładnie ten problem. Rozszerzenie zarządza regularnymi godzinami otwarcia, świętami i specjalnymi godzinami otwarcia w jednej strukturze danych i wyświetla we frontendzie aktualny status w czasie rzeczywistym: Otwarte (zielony) lub Zamknięte (czerwony), wraz z najbliższym terminem otwarcia. Rozszerzenie zostało zbudowane przez SLUB Drezno (Saksońska Biblioteka Krajowa, Państwowa i Uniwersytecka), która zna ten problem z praktyki.

Typowe scenariusze dotyczą bibliotek, muzeów i instytucji samorządowych

Podstawowym scenariuszem są biblioteki uczelniane z wieloma lokalizacjami. Biblioteka Uniwersytecka prowadzi cztery oddziały o różnych godzinach otwarcia. Główny gmach ma inne godziny niż filia, a w okresie wakacyjnym obowiązują skrócone godziny otwarcia. slub_web_openhours zarządza każdą lokalizacją jako osobnym rekordem z własnymi godzinami. Na stronie student od razu widzi, która lokalizacja jest właśnie otwarta i do której godziny.

Drugim scenariuszem są muzea i galerie. Muzeum Sztuki ma regularne godziny otwarcia (wt-nd 10-18, pn zamknięte), ale wydłużone godziny w trakcie wystawy specjalnej (codziennie do 21) i zamknięcia w święta. Rozszerzenie pozwala wprowadzać te wyjątki dla zdefiniowanych okresów bez zmiany regularnych godzin. Po upływie okresu specjalnego automatycznie obowiązują znów godziny standardowe.

Trzeci scenariusz: instytucje samorządowe takie jak biura obsługi mieszkańców, baseny i domy kultury. Miasto z 20 obiektami publicznymi prowadzi godziny otwarcia centralnie w backendzie TYPO3. Na każdej stronie obiektu widżet pokazuje aktualny status. Latem basen zewnętrzny ma inne godziny niż zimą, a w długie weekendy biuro obsługi mieszkańców jest zamknięte. Wszystko to można odwzorować przez rozszerzenie.

Architektura techniczna przechowuje reguły i wyjątki w kalendarycznej strukturze danych

Rozszerzenie definiuje trzy poziomy danych: regularne godziny (poniedziałek do niedzieli, godzina:minuta do godzina:minuta), wyjątki cykliczne (święta powtarzające się co roku) i wyjątki jednorazowe (zamknięcie 15 marca, wydłużone otwarcie 24 grudnia). Regularne godziny stanowią bazę, wyjątki je nadpisują. Logika jest prosta: czy dla bieżącej daty istnieje wyjątek? Jeśli tak, obowiązują godziny wyjątkowe. Jeśli nie, obowiązują regularne godziny dla danego dnia tygodnia.

Plugin frontendowy renderuje status przez szablony Fluid. Aktualny stan (otwarte/zamknięte) jest obliczany po stronie serwera i emitowany jako klasa CSS, dzięki czemu kolorystyką można sterować przez Tailwind lub własne CSS. Opcjonalnie widżet pokazuje najbliższy termin otwarcia: “Aktualnie zamknięte. Najbliższe otwarcie: poniedziałek, 08:00”.

Dla integracji ze Schema.org rozszerzenie może emitować OpeningHoursSpecification jako JSON-LD, co Google wyświetla we wpisach Knowledge Panel organizacji. Jest to szczególnie istotne dla instytucji widocznych w Google Maps, które chcą tam pokazywać poprawne godziny otwarcia.

Częste problemy dotyczą stref czasowych, brakujących świąt i cache’owania

Najczęstszym problemem jest cache. Gdy TYPO3 cache’uje stronę, a cache wygasa dopiero po dwóch godzinach, widżet przez nawet dwie godziny pokazuje błędny status. Rozwiązanie: osadzić widżet godzin otwarcia jako uncached plugin przez USER_INT. Kosztuje to minimalnie wydajności (jedno zapytanie do bazy na request), ale gwarantuje poprawny status.

Drugi problem: brakujące święta. Rozszerzenie nie dostarcza prekonfigurowanej listy świąt. Każda instytucja musi wprowadzić swoje święta ręcznie lub uzupełnić je przez import. W Polsce ważne jest uwzględnienie świąt państwowych takich jak 1 i 3 maja, 11 listopada, Boże Ciało, jak również odmiennych dat ruchomych. Można je importować skryptem z publicznych źródeł kalendarzowych.

Trzeci temat: strefy czasowe w instytucjach międzynarodowych. Rozszerzenie pracuje ze strefą czasową serwera. Gdy serwer TYPO3 działa w UTC, a instytucja w czasie środkowoeuropejskim, wyświetlane godziny się nie zgadzają. Rozwiązanie: ustawić strefę czasową PHP w konfiguracji TYPO3 na strefę instytucji, a w przypadku instytucji w wielu strefach dostosować obliczenie przez UTC+offset w szablonie Fluid.

Rozszerzenie działa pod TYPO3 v11 i v12, wsparcie dla v13 zależy od zespołu SLUB

slub_web_openhours jest utrzymywane przez SLUB Drezno jako projekt open source. Aktualizacje podążają za wewnętrznym cyklem wydawniczym biblioteki. TYPO3 v12 jest wspierany. Dla v13 kompatybilność zależy od tego, czy zespół deweloperski SLUB zaktualizuje rozszerzenie. Ponieważ technicznie jest ono szczupłe (brak skomplikowanych zależności API), migracja na v13 wymaga niewielkiego nakładu pracy. Gosign zaleca przy projektach godzin otwarcia walidować równolegle wyjście Schema.org po stronie Google, aby godziny otwarcia poprawnie pojawiały się w Google Maps i Knowledge Panel.