Rozszerzenie TYPO3 niekompatybilne – co zrobić przy aktualizacji?

W skrócie: Jeśli rozszerzenie nie obsługuje nowej wersji TYPO3, są cztery drogi: zaktualizować je do nowszej wersji, zastąpić utrzymywaną alternatywą, odwzorować funkcję wbudowanymi narzędziami TYPO3 albo samodzielnie dostosować rozszerzenie. Która droga pasuje, pokazuje analiza przed aktualizacją.

Rdzeń TYPO3 da się niezawodnie podnosić z wersji na wersję. Hamulcem są niemal zawsze rozszerzenia: kalendarz, moduł aktualności, wtyczka formularzy albo rozszerzenie, które agencja lata temu napisała specjalnie dla Państwa.

Jak rozpoznać, czy rozszerzenie jest kompatybilne

• Extension Repository (extensions.typo3.org): Przy każdym rozszerzeniu podane jest, które wersje TYPO3 obsługuje i kiedy ukazała się ostatnia wersja.
• composer.json lub ext_emconf.php: W zależnościach rozszerzenia określono, z którymi wersjami TYPO3 działa.
• Extension Scanner: W Install Tool w sekcji „Upgrade“ TYPO3 przeszukuje kod rozszerzeń pod kątem miejsc, które w nowszych wersjach zmieniono lub usunięto.
• Ostatnia aktywność: Jeśli rozszerzenie nie było aktualizowane od lat, to sygnał ostrzegawczy – nawet jeśli na papierze nadal pasuje.

Rozwiązanie 1: Nowsza wersja rozszerzenia

Najprostszy przypadek. Wiele popularnych rozszerzeń jest utrzymywanych i ukazuje się dla każdej nowej wersji LTS. Przy przeskoku o kilka wersji może być konieczne aktualizowanie także rozszerzenia krok po kroku i wykonanie jego własnych kroków migracji.

Rozwiązanie 2: Zamiana na utrzymywaną alternatywę

Dla porzuconych rozszerzeń często istnieje następca. Znany przykład to RealURL: rozszerzenie do przyjaznych adresów URL jest zbędne od TYPO3 9, bo TYPO3 samo obsługuje routing. Podobnie wiele projektów zastępuje starsze rozszerzenia siatek dla elementów treści nowszymi rozwiązaniami. Ważne przy zmianie: istniejące treści trzeba przenieść – to część planowania.

Rozwiązanie 3: Wbudowane narzędzia TYPO3

TYPO3 przez lata włączyło do rdzenia wiele rzeczy, do których kiedyś potrzebne było rozszerzenie: routing, framework formularzy, funkcje SEO jak meta tagi i mapy witryny XML. Zamiast ciągnąć za sobą stare rozszerzenie, często czyściej jest odwzorować funkcję rdzeniem – i mieć o jedną zależność mniej.

Rozwiązanie 4: Samodzielne dostosowanie rozszerzenia

Przy rozszerzeniach pisanych na zamówienie zostaje tylko ta droga; także przy porzuconych rozszerzeniach bez alternatywy może mieć sens. Extension Scanner pokazuje miejsca do zmiany, a informacje o zmianach od TYPO3 wyjaśniają, czym je zastąpić. Nakład pracy wynosi od kilku godzin do kilku dni – zależnie od zakresu i wieku kodu.

Czego lepiej nie robić

• „Obchodzić“ ograniczeń wersji: Zmiana deklaracji kompatybilności rozszerzenia bez dostosowania kodu prowadzi do błędów – często dopiero w trakcie działania strony.
• Odkładać z tego powodu aktualizację: Pojedyncze rozszerzenie rzadko jest powodem, by rezygnować z aktualizacji bezpieczeństwa. Prawie zawsze jest któraś z czterech dróg.
• Odkrywać problem dopiero przy aktualizacji: Kto sprawdzi rozszerzenia wcześniej, zna nakład pracy i koszty, zanim zacznie.

Jak pracuję

W analizie TYPO3 za 150 € netto spisuję wszystkie rozszerzenia Państwa strony i oceniam każde: kompatybilne, do zaktualizowania, do zastąpienia lub do dostosowania. Z tego wynika stała cena aktualizacji – bez niespodzianek w połowie pracy.

Więcej: Aktualizacja TYPO3 oraz Opieka techniczna TYPO3 oraz Aktualizacja TYPO3 z wersji 10 lub 11 do 14: przebieg, czas i koszty.

Stan: październik 2026. Źródła: docs.typo3.org (instrukcja aktualizacji, Extension Scanner), extensions.typo3.org.