gb_events dla TYPO3

Nie każde wydarzenie wymaga rejestracji, ale każde wymaga przyzwoitej prezentacji

sf_event_mgt to standard zarządzania wydarzeniami w TYPO3: rejestracja, lista oczekujących, płatność, zarządzanie uczestnikami. Jednak wiele organizacji jedynie pokazuje wydarzenia, bez rejestracji online. Kalendarz koncertów, program wydarzeń gminy, terminy uniwersytetu ludowego - we wszystkich tych scenariuszach sf_event_mgt byłoby przesadą. gb_events wypełnia tę lukę: prostą prezentację wydarzeń z widokiem kalendarza, bez obciążenia pełnego systemu zarządzania wydarzeniami.

Rozszerzenie jest przeznaczone dla organizacji, które chcą publikować terminy, a nie nimi zarządzać. Brak formularza rejestracji, brak listy uczestników, brak obsługi płatności. Za to czysta prezentacja listowa, widok kalendarza i strona szczegółów dla każdego wydarzenia.

Typowe scenariusze zastosowań

Strony gmin i parafii. Nabożeństwa, koncerty, festyny gminne, spotkania seniorów - typowy kalendarz gminy ma 20-40 wydarzeń miesięcznie. Odwiedzający chcą zobaczyć, co i kiedy się odbywa, i może przenieść terminy do własnego kalendarza. Rejestracja nie jest potrzebna, wydarzenia są publiczne. gb_events obsługuje to przy minimalnej konfiguracji.

Uniwersytety ludowe i placówki edukacyjne (przegląd programu). Zapisy na kursy odbywają się przez zewnętrzny system (Kufer, WebOpac), ale program ma być przeszukiwalny na stronie TYPO3. gb_events pokazuje kursy jako listę wydarzeń, filtrowaną według kategorii (języki, kreatywność, IT, zdrowie) i okresu. Strona szczegółów zawiera link do zewnętrznego systemu rejestracji.

Cykle wydarzeń z powtarzającymi się terminami. Klub sportowy ma treningi w poniedziałki i środy, spotkania towarzyskie w każdy pierwszy czwartek. gb_events prezentuje powtarzające się terminy bez konieczności ręcznego zakładania każdego pojedynczo. Powtarzanie jest konfigurowane, a gb_events generuje terminy automatycznie.

Architektura techniczna

gb_events opiera się na Extbase/Fluid i używa własnej tabeli tx_gbevents_domain_model_event. Każde wydarzenie ma pola: tytuł, opis, data rozpoczęcia, data zakończenia, miejsce, obraz, kategoria i opcjonalnie regułę powtarzania. Kategorie korzystają z systemowych kategorii TYPO3, co upraszcza integrację z innymi rozszerzeniami.

Frontend składa się z trzech widoków: listowego (chronologicznego, filtrowanego według kategorii i okresu), kalendarzowego (widok miesięczny z klikalnymi dniami) i szczegółowego (pełne informacje o wydarzeniu). Wszystkie widoki to szablony Fluid i można je nadpisać w sitepackage.

Widok kalendarza renderuje siatkę HTML-tabeli z 7 kolumnami (dni tygodnia) i 4-6 wierszami (tygodnie). Każda komórka zawiera wydarzenia danego dnia jako linkowane tytuły. Nawigacja między miesiącami odbywa się przez parametr linku (GET), a nie przez AJAX. Jest to przyjazne SEO, ponieważ każdy miesiąc ma własny URL, który może zostać zaindeksowany przez Google.

Logika powtarzania działa podobnie jak w calendarize: rekord z regułą powtarzania generuje wirtualne wydarzenia. Są one obliczane w czasie uruchomienia, a nie materializowane w bazie danych. Oszczędza to pamięć, ale wymaga czasu obliczeniowego przy każdym żądaniu strony. Framework cache TYPO3 neutralizuje tę wadę w przypadku stron cachowanych.

Częste problemy i rozwiązania

Wydarzenia nie pojawiają się w widoku listy. Częsta przyczyna: folder przechowywania (Storage PID) w pluginie nie odpowiada folderowi, w którym założono wydarzenia. gb_events filtruje wydarzenia według Storage PID. Rozwiązanie: w FlexForm pluginu wybrać poprawny folder lub zdjąć ograniczenie przez TypoScript (persistence.storagePid = 0 pokazuje wydarzenia ze wszystkich folderów).

Przeszłe wydarzenia znikają natychmiast. gb_events domyślnie ukrywa wydarzenia, gdy tylko data zakończenia zostanie przekroczona. W niektórych przypadkach (archiwum wydarzeń, referencje) przeszłe wydarzenia powinny pozostać widoczne. Rozwiązanie: dostosować zapytanie Repository w kontrolerze (włączyć przeszłe wydarzenia) lub skonfigurować osobny tryb widoku listy “Archiwum”.

Brak funkcji eksportu iCal. Odwiedzający chcą przenieść wydarzenia do swojego kalendarza. gb_events domyślnie nie oferuje pobierania .ics. Rozwiązanie: utworzyć własny typ strony dla eksportu iCal. Szablon Fluid generuje wynik zgodny z iCalendar (VCALENDAR, VEVENT, DTSTART, DTEND, SUMMARY, LOCATION). Nakład pracy to około 3 godzin rozwoju.

Migracja i kompatybilność wersji

gb_events obsługuje TYPO3 v10 i v11. Dla v12 istnieje wersja społecznościowa na GitHubie, ale kompatybilność nie jest w pełni zweryfikowana. Dla v13 na razie nie ma planów.

Alternatywą dla TYPO3 v12/v13 jest sf_event_mgt - znacznie obszerniejsze i lepiej utrzymywane rozszerzenie wydarzeń. sf_event_mgt oficjalnie obsługuje v12 i v13. Kto nie potrzebuje funkcji rejestracji, może skonfigurować sf_event_mgt bez rejestracji i nadal używać prezentacji wydarzeń i widoku kalendarza. Zakres funkcji jest większy, ale też złożoność.

Migracja z gb_events na sf_event_mgt wymaga migracji danych: przeniesienia wydarzeń z tx_gbevents_domain_model_event do tx_sfeventmgt_domain_model_event. Pola są podobne (tytuł, opis, data, miejsce), ale nie identyczne. Skrypt migracyjny oparty na SQL załatwia to w 1-2 godziny. Szablony Fluid trzeba dostosować, ponieważ sf_event_mgt używa innych ViewHelperów i zmiennych.

Dla projektów z kilkoma wydarzeniami (poniżej 50 rocznie) możliwe jest również własne rozwiązanie oparte na tx_news: wydarzenia jako rekordy news z polami daty i widok kalendarza w szablonie. Gosign doradza w wyborze najbardziej ekonomicznego rozwiązania i w razie potrzeby przeprowadza migrację.