sf_event_mgt dla TYPO3

sf_event_mgt rozwiązuje problem, że wydarzenie bez rejestracji nie jest wydarzeniem

Gdy strona TYPO3 zarządza więcej niż dwoma terminami rocznie i musi przyjmować uczestników, każde improwizowane rozwiązanie złożone z list stron, wtyczek kalendarza i formularzy powermail napotyka swoje granice. sf_event_mgt to rozszerzenie, które łączy te klocki w prawdziwy system wydarzeń: zarządzanie uczestnikami z przejściami statusów, listy oczekujących z automatycznym awansem, płatności przez kilku providerów i zautomatyzowana komunikacja e-mailowa przez cały cykl życia uczestnictwa. Kto w TYPO3 regularnie organizuje wydarzenia ze stałymi miejscami, praktycznie nie ominie tego rozszerzenia. Torben Hansen zbudował sf_event_mgt od początku jako narzędzie natywne dla Extbase, które płynnie wpasowuje się w istniejące instalacje TYPO3 i można je nadpisywać w każdym miejscu bez forkowania rozszerzenia core.

Typowe scenariusze zastosowania sięgają od targów po programy akademickie

Uczelnie wykorzystują sf_event_mgt na dni informacyjne, wykłady próbne i programy dokształcające. W praktyce oznacza to często: 30 równoległych kursów z własną pojemnością, rozstawem cenowym i łańcuchem e-mailowym do zainteresowanego, uczestnika i organizatora. Rozszerzenie zarządza tym przez jedną strukturę danych, wraz z wielojęzycznością dla studentów międzynarodowych. Na typowej uczelni wdrożyliśmy sf_event_mgt z około 400 pojedynczymi wydarzeniami rocznie, w tym kursami przygotowawczymi, dniami otwartych laboratoriów i spotkaniami absolwentów.

Stowarzyszenia i izby organizują w ten sposób konferencje branżowe i seminaria, w których uczestnicy płacą różne ceny w zależności od statusu członkowskiego. Typowa instalacja izby gospodarczej pracuje z 40 do 80 wydarzeniami rocznie, wiele z nich płatnych i z kilkoma klasami cenowymi. Członkowie płacą cenę regularną, niezrzeszeni dopłatę, a early-bird rabat. Rozszerzenie obsługuje to przez kategorie cenowe, które można konfigurować per wydarzenie, bez konieczności ingerencji dewelopera.

Firmy z kolei używają sf_event_mgt do wewnętrznych szkoleń, eventów dla klientów i webinarów. Szczególnie w obszarze B2B ważna jest funkcja eksportu CSV: lista uczestników następnie trafia do CRM albo do drukarki identyfikatorów na miejscu. W koncernie przemysłowym z 12 000 pracowników podłączyliśmy rozszerzenie do wewnętrznego systemu Learning-Management, dzięki czemu zapisy szkoleniowe automatycznie lądują w systemie kadrowym, a uczestnictwo jest dokumentowane jako dowód dokształcania.

Architektura techniczna oparta jest na Extbase i FAL

sf_event_mgt to klasyczne rozszerzenie Extbase i podąża za wzorcem MVC TYPO3. Centralne modele to Event, Registration, Location i Organisator, konfiguracja odbywa się przez TypoScript i szablony Fluid. Prawie wszystko można dostosować przez constants.typoscript lub TSconfig, bez forkowania rozszerzenia. Wariant plugin oferuje ponad tuzin akcji kontrolera, od widoku listy i widoku szczegółowego przez flow rejestracji po filtr wyszukiwania i kategorii.

Dla płatności rozszerzenie przynosi abstrakcję Payment, która obejmuje fakturę i przelew; Stripe i PayPal są dostępne jako płatne rozszerzenia dodatkowe autora. Własnych providerów płatności można podłączyć, implementując klasę dziedziczącą po AbstractPayment wraz z event listenerami PSR-14. Status płatności trafia do rekordu rejestracji, z metodą płatności, oznaczeniem opłacenia i referencją płatności. Nieudane płatności są dokumentowane i można je śledzić przez backend, bez konieczności przechodzenia redaktorów do konsoli providera płatności.

System e-mailowy opiera się na szablonach Fluid w katalogu EXT. Dla każdej rejestracji wyzwalanych jest kilka wiadomości: potwierdzenie do uczestnika i powiadomienie do organizatora; przypomnienia przed wydarzeniem lub e-maile po nim redaktorzy wysyłają jako własne powiadomienie z modułu backendu. Każda z tych wiadomości to szablon Fluid, który można nadpisać przez SiteSet lub PageTS. Maile są wysyłane przez TYPO3-Mailer i respektują globalne ustawienia SMTP wraz z SPF i DKIM. Dla uczestników z zarezerwowanymi miejscami na liście oczekujących są oddzielne szablony, które są wyzwalane przy awansie.

Częste problemy dotyczą list oczekujących, eksportu iCal i ReCaptcha

Najczęstszym tematem wsparcia jest logika listy oczekujących. Gdy uczestnik odwołuje, pierwszy wpis z listy oczekujących awansuje, ale tylko wtedy, gdy w wydarzeniu oprócz listy oczekujących i anulowania włączone jest automatyczne przesuwanie („Automatic waitlist move up”), a rezygnacja przychodzi przez frontend. Wiele instalacji zapomniało o tej opcji i dziwi się, dlaczego miejsca pozostają puste. Konfiguracja trwa pięć minut, ale bez tej opcji rozszerzenie pozostaje w trybie ręcznym.

Drugim stałym tematem jest eksport iCal. Uczestnicy chcą kliknięcia “Dodaj do kalendarza”, które działa w Outlooku, Apple Calendar i Google Kalendarz. sf_event_mgt dostarcza plik ICS z początkiem i końcem w UTC, które kalendarze przeliczają na czas lokalny; warunkiem jest poprawna strefa czasowa instalacji TYPO3. Inaczej wydarzenie pojawia się w Outlooku z godzinnym przesunięciem, szczególnie krytycznie przy zmianie na czas letni. Zalecamy, aby przy międzynarodowych wydarzeniach sprawdzić strefę czasową instalacji przed pierwszym eksportem.

Trzeci temat to ochrona antyspamowa. Publiczne formularze rejestracji przyciągają boty, które zalewają listy oczekujących. sf_event_mgt ma wbudowane pola honeypot, sprawdzanie linków, test challenge/response oraz obsługę reCAPTCHA i hCaptcha. W produkcyjnych instalacjach zalecamy łączyć oba mechanizmy i dodatkowo wbudować rate-limit per adres IP, żeby pojedyncze boty nie mogły zakładać setek fałszywych rejestracji.

Migracja na TYPO3 v12, v13 i v14

sf_event_mgt jest ciągle utrzymywane przez Torbena Hansena i dostępne dla TYPO3 od v10 do v14. Skok z v10 na v12 prowadzi przez wersję 6.0.0, która wymaga zmian w bazie danych i upgrade wizarda dla rozdzielonych pluginów; wersja 7.0.0 dla v12 nie wymaga aktualizacji bazy danych. Własne ViewHelpery rozszerzenia zostały przeniesione na nową wersję Fluid, własne szablony po update wymagają krótkiego przeglądu. Szczególnie własne szablony powiadomień i nadpisane szablony backendu muszą być sprawdzone, bo wersja 7.0.0 wymaga w backendzie f:format.raw zamiast f:format.html, a szablony backendu nadpisuje się przez PageTS.

Przy starszych wersjach (sf_event_mgt 4.x i wcześniejsze) warto spojrzeć na konfigurację płatności, bo rdzeń rozszerzenia nadal obejmuje tylko fakturę i przelew. Stripe i PayPal działają przez rozszerzenia dodatkowe sf_event_mgt_stripe i sf_event_mgt_paypal, które przy upgrade też trzeba sprawdzić. Gosign migruje istniejące instalacje sf_event_mgt zazwyczaj w jednym kroku wraz z upgrade core TYPO3. Szablony Fluid są przy tym ujednolicane na spójne identyfikatory, a przestarzałe wywołania ViewHelperów są automatycznie wykrywane i zastępowane. W tym samym kroku sprawdzamy, czy oznaczenie Schema.org/Event w JSON-LD jest aktualne i czy szablon detalu wydarzenia zawiera wszystkie pola dla Google Event Rich Snippets.