calendarize_news dla TYPO3

Wydarzenia w tx_news należą do kalendarza, nie do chronologicznej listy

Większość witryn TYPO3 wykorzystuje tx_news Georga Ringera do wszystkiego: aktualności, wpisów blogowych, komunikatów prasowych i wydarzeń. Dla pierwszych trzech typów chronologiczna lista działa. Dla wydarzeń nie. Odwiedzający oczekują widoku kalendarza z prezentacją miesięczną, tygodniową i dzienną. Chcą kliknąć na datę i zobaczyć, co się tego dnia odbywa. calendarize_news buduje dokładnie ten most: pobiera istniejące rekordy News z polami daty i renderuje je jako kalendarz.

Rozszerzenie oszczędza przejście na samodzielny system wydarzeń. Kto już korzysta z tx_news, zachowuje swoją strukturę danych, swoje szablony i swoje procesy redakcyjne. Zamiast drugiego rozszerzenia z oddzielnym przechowywaniem danych jest widok kalendarza na istniejących danych.

Typowe scenariusze zastosowania

Kalendarze wydarzeń na stronach firmowych. Placówka edukacyjna publikuje 150 seminariów rocznie przez tx_news. Każde seminarium ma datę początkową, datę końcową i godzinę. Bez calendarize_news odwiedzający widzą długą listę posortowaną po dacie. Z calendarize_news widzą kalendarz miesięczny, klikają na 15 maja i znajdują trzy seminaria. Konwersja z widoku kalendarza na stronę szczegółową u jednego klienta była o 40% wyższa niż z widoku listy.

Powtarzające się wydarzenia bez duplikacji danych. Cotygodniowe spotkanie, comiesięczny webinar, doroczna uroczystość firmowa: bez funkcjonalności powtarzania redaktor musi utworzyć 52 rekordy dla spotkania. calendarize_news obsługuje reguły powtarzania (dziennie, tygodniowo, miesięcznie, rocznie) z wyjątkami. Jeden rekord generuje 52 wpisy kalendarza. Gdy termin odpada, jest oznaczany jako wyjątek, nie usuwany.

Połączone strony aktualności i wydarzeń. Wiele organizacji na stronie głównej pokazuje “Aktualności” - mieszankę wiadomości i nadchodzących wydarzeń. calendarize_news umożliwia wyświetlanie tych samych rekordów na liście News chronologicznie i w kalendarzu według daty. Dwa widoki, jedno źródło danych, żadnego nakładu synchronizacji.

Architektura techniczna

calendarize_news to nakładka na rozszerzenie kalendarza calendarize tego samego autora (Tim Lochmüller). Dołącza do rekordów News w polu calendarize konfiguracje terminów: data początkowa, data końcowa, flaga całodniowa, reguła powtarzania i wyjątki. Z tych konfiguracji calendarize przy zapisie tworzy dla każdego pojedynczego terminu wpis w swojej tabeli indeksu.

Prezentacja kalendarza odbywa się przez szablony Fluid renderujące siatkę miesięczną. Każda komórka (dzień) zawiera wydarzenia tego dnia. Szablony są w pełni konfigurowalne. Domyślnie rozszerzenie dostarcza szablony dla widoku miesięcznego, tygodniowego i dziennego. Nawigacja między miesiącami odbywa się przez AJAX lub klasyczne wywołanie strony, konfigurowalne przez TypoScript.

Integracja z tx_news jest głęboka: calendarize_news rejestruje News jako typ wydarzenia w calendarize; widoki kalendarza dostarcza plugin calendarize, do którego calendarize_news dodaje pole dla strony News. Kategorie, tagi i ograniczenia dostępu z tx_news są przejmowane. Wydarzenie przypisane do kategorii “Wewnętrzne” i widoczne tylko dla zalogowanych użytkowników pojawia się w kalendarzu również tylko po zalogowaniu.

Funkcja eksportu iCal generuje pliki .ics dla pojedynczych wydarzeń lub całego kalendarza. Odwiedzający mogą importować wydarzenia bezpośrednio do Outlook, Apple Calendar lub Google Calendar. Eksport korzysta z formatu iCalendar (RFC 5545) i uwzględnia reguły powtarzania.

Częste problemy i rozwiązania

Kalendarz nie pokazuje wydarzeń, mimo że News istnieją. Najczęstsza przyczyna: pola daty rekordów News nie są wypełnione. tx_news ma pole datetime, ale terminy znajdują się w konfiguracjach calendarize, które trzeba najpierw dodać do istniejących rekordów News w polu calendarize. Rozwiązanie: skrypt migracji tworzący z datetime jedną konfigurację calendarize na rekord News - 30 minut pracy developerskiej.

Problemy wydajnościowe przy wielu powtarzających się wydarzeniach. Gdy 50 powtarzających się wydarzeń generuje po 52 terminy, indeks kalendarza zawiera 2600 wpisów, które widok miesięczny musi filtrować. To jest odczuwalne przy każdym niecachowanym wywołaniu strony. Rozwiązanie: dostarczać widok listy i widok miesięczny z cache, jak calendarize robi to domyślnie, i ograniczyć zakres czasowy, dla którego calendarize zapisuje terminy w indeksie (ustawienie tillDays). Wydarzenia odległe o więcej niż 12 miesięcy w przyszłość nie muszą znajdować się w indeksie.

Responsywne wyświetlanie siatki kalendarza. Siatka 7-kolumnowa dla dni tygodnia działa na desktopie, ale nie na smartfonach. Standardowe szablony calendarize_news nie są zoptymalizowane pod urządzenia mobilne. Rozwiązanie: dostosowanie szablonów Fluid i renderowanie na urządzeniach mobilnych widoku listy zamiast siatki. Breakpoint CSS przy 768px wystarczy do przełączania między siatką a listą.

Migracja i kompatybilność wersji

calendarize_news zależy od tx_news i calendarize. Aktualna wersja 9.0.0 wymaga TYPO3 13.4, tx_news od wersji 12 i calendarize 13 lub 14; dla TYPO3 v12 jest wersja 8.0.1.

calendarize (bez sufiksu _news) od lochmuellera to samodzielne rozszerzenie kalendarza z własnym modelem danych i zarazem podstawa, na której opiera się calendarize_news: terminy News leżą już w tabelach calendarize. Aktualna wersja 15 obsługuje TYPO3 13.4 i 14.

Dla projektów migrujących na TYPO3 v13 z zachowaniem tx_news najpragmatyczniejszą drogą jest: użycie calendarize_news w wersji 9 lub zbudowanie prezentacji kalendarza jako niestandardowego szablonu Fluid bezpośrednio w tx_news. Nakład pracy na niestandardowy szablon to 2-3 dni, a wynik jest niezależny od utrzymania osób trzecich. Gosign wdrożył obie drogi i rekomenduje odpowiedni wariant w zależności od złożoności reguł powtarzania.