news (tx_news) dla TYPO3

tx_news to rozszerzenie, bez którego nie obywa się żaden projekt TYPO3

Ponad 80 procent wszystkich instalacji TYPO3 korzysta z tx_news autorstwa Georga Ringera. Sama ta liczba byłaby już imponująca, ale nie oddaje znaczenia rozszerzenia: tx_news nie jest tylko pluginem newsowym, lecz fundamentem dla blogów, magazynów, sekcji prasowych, list wydarzeń, katalogów pracowników i każdego innego rodzaju ustrukturyzowanej, chronologicznej treści w TYPO3. Rozszerzenie dostarcza kategorie, tagi, zasoby multimedialne, pola SEO (canonical, OpenGraph, Schema.org), paginację oraz import/eksport z jednej aktywnie utrzymywanej bazy kodu. Kto publikuje treści redakcyjne w TYPO3, nie ominie tx_news.

Gosign skonfigurował, rozszerzył i zmigrował tx_news w setkach projektów. Od szablonów Fluid przez własne ViewHelpery po pełną migrację z tt_news. Rozszerzenie jest stałym elementem każdego setupu TYPO3, który dostarczamy.

Typowe scenariusze sięgają od firmowego bloga po bazę danych prasy

Najczęstszym scenariuszem jest blog firmowy lub magazyn online. Redaktorzy zarządzają artykułami w backendzie TYPO3 z tytułem, teaserem, treścią, kategoriami, tagami i mediami. Widok listy pokazuje teasery z obrazem, widok szczegółowy pełny artykuł. Istotne dla SEO pola takie jak meta-opis, canonical URL i obraz OpenGraph są uzupełniane dla każdego artykułu. Typowa instalacja ma od 100 do 5000 artykułów i rośnie o 2 do 10 artykułów tygodniowo.

Drugi scenariusz: komunikaty prasowe dla Investor Relations i komunikacji korporacyjnej. Spółki giełdowe i koncerny publikują obowiązkowe komunikaty przez sekcję prasową swojej strony. tx_news dostarcza chronologię, kategoryzację (raport bieżący, raport kwartalny, komunikat personalny) i funkcję pobierania dla załączonych PDF-ów. Funkcja archiwum zapewnia, że także komunikaty sprzed dziesięciu lat są nadal dostępne do wyszukania.

Trzeci scenariusz: listy wydarzeń i kalendarze. tx_news potrafi zarządzać datami początkowymi i końcowymi wpisów, co czyni go prostym kalendarzem wydarzeń. Dla stowarzyszeń, instytucji kulturalnych i placówek edukacyjnych często to wystarcza, bez konieczności stosowania wyspecjalizowanego rozszerzenia eventowego takiego jak sf_event_mgt. Dopiero gdy potrzebne są funkcje zapisu, zarządzania uczestnikami czy sprzedaży biletów, tx_news osiąga swoje granice.

Architektura techniczna konsekwentnie oddziela dane, konfigurację i prezentację

tx_news przechowuje artykuły jako rekordy Extbase w tabeli tx_news_domain_model_news. Każdy rekord zawiera pola obowiązkowe (tytuł, datetime, typ) i opcjonalne (teaser, treść, autor, tagi, kategorie, media, powiązane news). Relacje z kategoriami i tagami biegną przez tabele MM, co umożliwia wydajne filtrowanie.

Konfiguracja odbywa się przez TypoScript: ścieżki szablonów, sortowanie, paginacja, filtry kategorii, PID strony szczegółów i ustawienia SEO. Rozszerzenie dostarcza rozbudowany zestaw stałych TypoScript, który pokrywa większość konfiguracji bez własnego kodu. Dla wymagań niestandardowych (np. slider na stronie startowej pokazujący trzy najnowsze newsy) istnieją ViewHelpery, których można używać w szablonach Fluid.

Szablony Fluid dla list, szczegółów, kategorii i menu dat są nadpisywalne przez ścieżki TypoScript. W praktyce kopiuje się standardowe szablony do własnego Site-Package i dostosowuje strukturę HTML i klasy CSS do identyfikacji wizualnej. To oddzielenie umożliwia aktualizację rozszerzenia bez nadpisywania własnych modyfikacji.

Wydajność przy prawidłowej konfiguracji jest dobra: widok listy korzysta z page cache TYPO3, widok szczegółów cache’uje się dla każdego UID artykułu. Dopiero przy zasobach news powyżej 10 000 artykułów ze złożonymi filtrami kategorii i wyszukiwaniem pełnotekstowym wydajność staje się tematem. W takich przypadkach zaleca się indeks wyszukiwania przez ke_search lub Solr.

Częste problemy dotyczą konfiguracji SEO, wydajności i migracji z tt_news

Problem pierwszy: brakujące lub błędne canonical URL. Bez prawidłowej konfiguracji ten sam artykuł jest osiągalny przez kilka URL-i: przez ścieżkę kategorii, ścieżkę archiwum i link bezpośredni. Google indeksuje wszystkie warianty jako osobne strony, co prowadzi do Duplicate Content. Rozwiązanie: wyraźnie ustawić PID strony szczegółów i skonfigurować canonical URL w ustawieniach TypoScript na stronę szczegółów. Rozszerzenie newscanonical dodatkowo adresuje ten problem.

Problem drugi: spadki wydajności przy dużych zasobach news. Gdy widok listy musi przeszukać ponad 5000 artykułów, rosną czasy zapytań do bazy danych. Rozwiązanie: ograniczenia oparte na kategoriach w konfiguracji TypoScript, paginacja z maksymalnie 20 artykułami na stronę i indeksy bazy danych na relacjach kategorii.

Problem trzeci: migracja z tt_news. Legacy rozszerzenie tt_news nie jest kompatybilne od TYPO3 v8. Migracja danych do tx_news wymaga mapowania pól (tt_news_cat do sys_category, szablony Marker do szablonów Fluid) i strategii przekierowań URL, aby zachować istniejące rankingi Google. Gosign używa do tego analizy szablonów wspieranej AI: nasze narzędzia czytają stare szablony Marker, identyfikują używane pola i generują szablony Fluid, które produkują ten sam wynik.

tx_news w pełni obsługuje TYPO3 v12 i v13

Georg Ringer aktywnie utrzymuje tx_news i przy każdym wydaniu TYPO3 LTS szybko dostarcza kompatybilną wersję. Aktualna seria obsługuje TYPO3 v11, v12 i v13 równolegle. Przy aktualizacji z v10 lub v11 do v12 Breaking Changes dotyczą przede wszystkim własnych ViewHelperów, które muszą zostać przełączone na aktualne API Fluid, oraz konfiguracji TypoScript, które powinny zostać zmigrowane do nowej składni SiteSet. Struktura rekordów pozostaje stabilna, migracja danych nie jest konieczna. Gosign wykonuje aktualizacje tx_news zwykle w ramach aktualizacji rdzenia TYPO3 i sprawdza przy tym własne szablony, ViewHelpery i nadpisania TypoScript pod kątem kompatybilności. Dla projektów z rozbudowanymi dostosowaniami (pola własne, własne ViewHelpery, integracja z systemami trzecimi) przed aktualizacją tworzymy macierz kompatybilności, która dokumentuje wszystkie zależności i realistycznie szacuje nakład migracji. Analiza kodu wspierana AI znacząco przyspiesza ten proces, identyfikując wszystkie miejsca w projekcie dotknięte zmianami API.