tt_news Migracja dla TYPO3

Kto jeszcze używa tt_news, blokuje każdą aktualizację TYPO3 od wersji 10

tt_news był przez ponad dekadę standardowym rozszerzeniem do aktualności, komunikatów prasowych i wpisów blogowych w TYPO3. Tysiące stron zostało z nim zbudowanych, niektóre z setkami lub tysiącami artykułów. Problem: tt_news było ostatnio oficjalnie wspierane dla TYPO3 v7. Od TYPO3 v8 (2017) nie ma kompatybilnego wydania. Kto nadal ma tt_news w użyciu, siedzi na przestarzałej wersji TYPO3 i nie może korzystać ani z aktualizacji bezpieczeństwa, ani z nowych funkcji.

Oficjalnym następcą jest GeorgRinger/news (w skrócie: EXT:news), rozwijane od 2012 roku. news to najczęściej instalowane rozszerzenie TYPO3 (ponad 250 000 aktywnych instalacji, stan 2026), wspierające TYPO3 v11, v12 i v13. news_ttnewsimport to rozszerzenie migracyjne automatyzujące przejście: artykuły, kategorie, obrazy, Related News i odwołania do stron są przenoszone z tt_news do EXT:news.

Typowe scenariusze zastosowań

Aktualizacja TYPO3 z v7/v8/v9 na v12 lub v13. Najczęstszy przypadek: firma prowadzi stronę TYPO3 na v7 lub v9, z 500 do 5000 artykułami w tt_news. Planowana aktualizacja do v12 LTS nie udaje się z powodu tt_news, bo rozszerzenie nie jest kompatybilne. news_ttnewsimport przenosi wszystkie dane do struktury EXT:news, dzięki czemu aktualizacja może być kontynuowana.

Relaunch z istniejącymi danymi. Przy relaunchu strony design ma być zupełnie nowy, ale istniejące artykuły mają być zachowane. Artykuły przez lata zbudowały wartość SEO (backlinki, indeksacja, pozycje). Nowy start bez migracji zniszczyłby tę wartość. news_ttnewsimport zachowuje treści, EXT:news dostarcza nowoczesną technikę.

Środowiska Multi-Site ze wspólną bazą aktualności. Koncerny z 5 do 20 instancjami TYPO3 pielęgnujące aktualności centralnie i wyświetlające je na wszystkich witrynach. Migracja musi przebiegać skoordynowanie: najpierw migracja centralnej bazy danych, potem dostosowanie szablonów na wszystkich witrynach.

Architektura techniczna

news_ttnewsimport to rozszerzenie oparte na CLI, działające przez TYPO3 Command Controller. Proces migracji przebiega w pięciu krokach. Najpierw kategorie tt_news (tt_news_cat) są przekształcane w wpisy sys_category. Hierarchia kategorii (Parent-Child) jest zachowywana. Następnie migrowane są same rekordy aktualności: tytuł, teaser, bodytext, autor, data, typ, data archiwum i status Hidden/Deleted. W trzecim kroku obrazy i media są konwertowane ze starej struktury przechowywania na referencje FAL. Czwarty krok migruje Related News jako relacje. W ostatnim kroku aktualizowane są elementy treści na stronach aktualności: pluginy tt_news są zastępowane pluginami EXT:news.

Częste problemy i rozwiązania

Brak obrazów po migracji. tt_news przechowywało obrazy jako nazwy plików w polu tekstowym (np. “obraz1.jpg,obraz2.jpg”), pliki leżały w uploads/pics/. EXT:news używa FAL. Jeśli fizyczne pliki nie znajdują się już w oczekiwanym katalogu, migracja obrazów nie udaje się. Rozwiązanie: przed migracją sprawdzić, czy wszystkie odwołane obrazy fizycznie istnieją.

Przypisania kategorii giną. tt_news korzystało z własnych tabel kategorii (tt_news_cat), EXT:news używa sys_category. Jeśli migracja nie mapuje prawidłowo identyfikatorów kategorii, artykuły tracą przypisania. Rozwiązanie: news_ttnewsimport tworzy mapowanie (stary ID na nowy ID) i aktualizuje wszystkie odwołania.

Struktura URL zmienia się, pozycje SEO spadają. Artykuły tt_news miały URL jak /news/detail/tytuł-artykulu/. EXT:news domyślnie generuje /news/tytuł-artykulu/. Rozwiązanie: skonfigurowanie przekierowań 301 ze starych na nowe URL. Przy 1000 artykułach to ręcznie niemożliwe. Gosign automatycznie generuje mapę przekierowań ze starych i nowych struktur URL.

Migracja i kompatybilność wersji

news_ttnewsimport wspiera migrację do EXT:news na TYPO3 v11 i v12. Zalecany przebieg: najpierw aktualizacja TYPO3 do v11 (jeśli z v7/v8/v9, stopniowo), potem uruchomienie news_ttnewsimport, potem aktualizacja do v12 lub v13.

Dla bardzo dużych zbiorów danych (ponad 10 000 artykułów) Gosign zaleca przeprowadzenie migracji na systemie staging i sprawdzenie wyniku, zanim produkcja zostanie przełączona. Sama migracja trwa od 30 minut (500 artykułów) do 4 godzin (10 000 artykułów z obrazami). Dostosowanie szablonów (szablony Fluid dla nowego wyjścia EXT:news) to oddzielny nakład, typowo 2 do 5 dni.

Często niedocenianym aspektem migracji tt_news jest komunikacja z wyszukiwarkami. Google zaindeksowało stare URL i je ocenia. Jeśli po migracji 500 URL prowadzi donikąd (404), strona traci pozycje rankingowe. Gosign dlatego po każdej migracji konfiguruje monitoring przekierowań: tydzień po uruchomieniu dane Google Search Console są sprawdzane pod kątem błędów 404, brakujące przekierowania są uzupełniane.