Migracja starej Joomla bez utraty adresów URL

Największym błędem jest traktowanie migracji jak zwykłej aktualizacji

Stary serwis Joomla często zawiera kilka lat treści, setki lub tysiące adresów, niestandardowe moduły, dodatki, formularze i rozwiązania, których nikt już dokładnie nie pamięta. Próba podniesienia wszystkiego jednym ruchem może skończyć się stroną, która technicznie działa, ale traci część funkcji albo zmienia adresy ważnych materiałów.

Bezpieczniejsza migracja zaczyna się od rozpoznania tego, co naprawdę trzeba zachować.

1. Najpierw inwentaryzacja starej strony

Przed jakąkolwiek zmianą warto spisać wersję Joomla, wersję PHP, używany szablon, rozszerzenia, dodatkowe komponenty, moduły i pluginy. Trzeba też sprawdzić, które z nich są faktycznie używane. Stare instalacje bardzo często zawierają dodatki pozostawione po wcześniejszych przebudowach.

Osobno warto zinwentaryzować rodzaje treści: artykuły, kategorie, kontakty, galerie, dokumenty, formularze, użytkowników, pozycje menu oraz nietypowe tabele w bazie danych.

2. Adresy URL trzeba potraktować jak dane

Jeżeli artykuł od lat znajduje się pod konkretnym adresem i jest widoczny w Google, linkowany z innych stron albo zapisany przez użytkowników, ten adres ma wartość. Nie należy zmieniać go tylko dlatego, że nowy system potrafi wygenerować „ładniejszy”.

Przed migracją dobrze jest zebrać listę istniejących adresów. Po uruchomieniu nowej wersji można ją porównać z nowym serwisem. Jeżeli adres musi się zmienić, stary powinien prowadzić do właściwego nowego miejsca przez stałe przekierowanie 301.

Szczególnej uwagi wymagają aliasy kategorii, struktura menu i ustawienia SEF. To one często decydują o tym, czy po migracji adres pozostanie identyczny.

3. Migrację robi się na kopii, nie na działającej stronie

Nową wersję najlepiej przygotować w środowisku testowym. Pozwala to wielokrotnie przeprowadzać import, sprawdzać błędy, poprawiać mapowanie danych i testować rozszerzenia bez przerywania pracy obecnego serwisu.

Kopia testowa powinna być zabezpieczona przed indeksowaniem. Google nie potrzebuje drugiej, tymczasowej wersji tej samej strony.

4. Nie każde stare rozszerzenie powinno być przeniesione

Migracja jest dobrym momentem na odchudzenie instalacji. Część rozszerzeń nie ma wersji dla nowej Joomla, część nie jest już potrzebna, a część funkcji można dziś zrealizować prostszymi środkami.

Najpierw warto ustalić, jaką funkcję pełnił dany dodatek, a dopiero potem szukać jego odpowiednika. Mechaniczne przenoszenie całego zestawu rozszerzeń utrwala stare problemy i zwiększa przyszłe koszty utrzymania.

5. Szablon zwykle lepiej przebudować niż przenosić

Wieloletni szablon może zawierać zależności od starego frameworka, przestarzały JavaScript i nadpisania, które nie pasują do nowej wersji Joomla. Zamiast próbować zachować go za wszelką cenę, często bezpieczniej jest odtworzyć wygląd i najważniejsze zachowania na współczesnej bazie.

Przy okazji można poprawić responsywność, dostępność, wydajność i uprościć kod bez zmiany charakteru serwisu.

6. Treści powinny być migrowane osobno od wyglądu

Artykuły, kategorie i podstawowa struktura informacji są zwykle bardziej trwałe niż szablon. Rozdzielenie tych dwóch warstw upraszcza testowanie. Najpierw sprawdza się kompletność danych, później sposób ich prezentacji.

7. Przed przełączeniem domeny trzeba zrobić test końcowy

Warto ponownie sprawdzić najważniejsze stare adresy, menu, formularze, wyszukiwarkę, logowanie, multimedia, wersję mobilną i funkcje redakcyjne. Dobrze też porównać liczbę artykułów i kategorii oraz upewnić się, że pliki i obrazy zostały przeniesione.

Po uruchomieniu nowej wersji trzeba obserwować błędy 404, przekierowania, mapę witryny i informacje w Google Search Console. Pierwsze dni po migracji są najlepszym momentem na wyłapanie pojedynczych adresów, które zostały pominięte.

Najczęstsze błędy przy migracji Joomla

Najczęściej problemem nie jest sama baza danych, lecz brak planu: zmiana wszystkich adresów naraz, instalowanie przypadkowych zamienników rozszerzeń, praca bez pełnej kopii, testowanie bezpośrednio na produkcji albo próba zachowania każdego elementu starego serwisu tylko dlatego, że „zawsze tam był”.

Migracja jest udana wtedy, gdy użytkownik nadal trafia tam, gdzie wcześniej, redakcja potrafi normalnie pracować, a nowa instalacja jest prostsza do utrzymania od starej.