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 wspiera Stripe, PayPal, Invoice i Klarna przez klasy handlerów. Własnych providerów płatności można podłączyć, implementując klasę PaymentServiceInterface. Rozliczenia trafiają do własnego logu płatności i mogą być przetwarzane przez TYPO3-Scheduler. 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, powiadomienie do organizatora, przypomnienia przed wydarzeniem, e-mail po wydarzeniu. 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 admin aktywował kontroler polecenia “moveUpWaitlistRegistrations” przez Scheduler. Wiele instalacji o tym zapomniało i dziwi się, dlaczego miejsca pozostają puste. Konfiguracja trwa pięć minut, ale bez zadania Schedulera 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, ale poprawne strefy czasowe i bloki VTIMEZONE muszą być ustawione przez konfigurację. Inaczej wydarzenie pojawia się w Outlooku z godzinnym przesunięciem, szczególnie krytycznie przy zmianie na czas letni. Zalecamy, aby przy międzynarodowych wydarzeniach przechowywać w ICS zarówno lokalną strefę czasową, jak i UTC.

Trzeci temat to ochrona antyspamowa. Publiczne formularze rejestracji przyciągają boty, które zalewają listy oczekujących. sf_event_mgt wspiera pola honeypot i można go połączyć z ext:kestura_recaptcha lub natywnym TYPO3-Captcha. 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 i v13 nie jest krytyczna

sf_event_mgt jest ciągle utrzymywane przez Torbena Hansena i dostępne dla TYPO3 v11, v12 i v13. Skok z v10 na v12 nie przynosi breaking changes w strukturze bazy danych, wszystkie pola pozostają kompatybilne. Własne ViewHelpery rozszerzenia zostały przeniesione na nową wersję Fluid, własne szablony po update wymagają krótkiego przeglądu. Szczególnie finisher rejestracji i szablony e-maili muszą być sprawdzone, bo TYPO3 v12 wprowadziło surowsze reguły obsługi błędów.

Przy starszych wersjach (sf_event_mgt 4.x i wcześniejsze) warto spojrzeć na konfigurację płatności, bo Stripe-API przeskoczyło kilka generacji. Aktualne rozszerzenie wspiera Stripe Elements i 3D Secure 2, starsze wersje pracowały jeszcze ze Stripe Sources, które są już deprecated. 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.