Kontrolný zoznam pred upgrade Joomla stránky

Upgrade Joomla stránky by nemal začínať kliknutím na tlačidlo Aktualizovať. Najprv je potrebné preveriť server, rozšírenia, šablónu, databázu, zálohu a možnosti návratu k pôvodnej verzii. Dôkladná príprava výrazne znižuje riziko nefunkčnej stránky, chýb v administrácii alebo straty údajov.

Upgrade nie je bežná aktualizácia

Pri menšej aktualizácii v rámci rovnakej hlavnej verzie sa spravidla opravujú chyby a bezpečnostné nedostatky. Upgrade medzi hlavnými verziami, napríklad z Joomla 4 na Joomla 5 alebo z Joomla 5 na Joomla 6, môže priniesť:

• vyššie požiadavky na PHP a databázu,
• odstránenie zastaraných častí programového rozhrania,
• zmeny v šablónach a prepisoch výstupu,
• nekompatibilitu starších rozšírení,
• potrebu úprav vlastného kódu.

Joomla sa snaží zachovať spätnú kompatibilitu v rámci jednej hlavnej série. Minimálne technické požiadavky sa však môžu zvýšiť pri vydaní novej hlavnej verzie. Návrat na staršiu verziu systému nie je podporovaný, preto sa pri neúspešnom upgrade počíta s obnovením stránky zo zálohy.

1. Zistite aktuálny stav stránky

Pred prípravou upgrade si zaznamenajte základné technické údaje:

• aktuálnu verziu Joomla,
• cieľovú verziu Joomla,
• verziu PHP,
• typ a verziu databázy,
• názov šablóny a jej frameworku,
• všetky nainštalované komponenty, moduly a pluginy,
• jazykové balíky,
• vlastné úpravy a template overrides,
• prepojenia na externé služby.

Informácie o serveri nájdete v administrácii v časti Systém – Systémové informácie. Pri zložitejších stránkach je vhodné vytvoriť si jednoduchú tabuľku so zoznamom rozšírení, ich verziami, výrobcom a potvrdenou podporou cieľovej verzie Joomla.

Nezabudnite ani na menej viditeľné prvky. Problém môže spôsobiť starý systémový plugin, editor, autentifikačný doplnok, knižnica, jazykový balík alebo rozšírenie, ktoré už na stránke aktívne nepoužívate.

2. Určte správnu cestu upgrade

Pri upgrade medzi hlavnými verziami nemožno ľubovoľne preskakovať medziverzie. Zdrojová stránka musí byť najskôr aktualizovaná na poslednú verziu vetvy, ktorá je určená ako východiskový bod upgrade.

Typickými príkladmi sú:

• Joomla 3.10 ako východisko pre prechod na Joomla 4,
• Joomla 4.4 pred prechodom na Joomla 5,
• Joomla 5.4 pred prechodom na Joomla 6.

Oficiálna dokumentácia pre prechody z Joomla 4.4 na 5 a z Joomla 5.4 na 6 odporúča venovať osobitnú pozornosť predaktualizačnej kontrole a kompatibilite všetkých rozšírení.

Pri veľmi starej alebo dlhodobo neudržiavanej stránke môže byť bezpečnejšie rozdeliť upgrade na viac samostatných etáp. Po každej etape treba stránku skontrolovať a vytvoriť novú zálohu.

3. Prečítajte si informácie o cieľovej verzii

Pred upgrade si otvorte oficiálne oznámenie o vydaní cieľovej verzie a skontrolujte:

• opravené bezpečnostné chyby,
• známe problémy,
• zmeny technických požiadaviek,
• informácie o spätnej kompatibilite,
• prípadné dočasné riešenia alebo opravné balíky.

Táto kontrola nie je iba formalita. Aj stabilné vydanie môže obsahovať novoobjavený problém, ku ktorému Joomla následne zverejní odporúčanie alebo hotfix. Napríklad pri niektorých vydaniach Joomla 5.4 a 6.1 boli známe problémy a ich riešenia doplnené priamo do oficiálneho oznámenia.

Pri bezpečnostnej aktualizácii netreba upgrade zbytočne odkladať. Ak však nejde o kritickú opravu a stránka používa množstvo rozšírení, krátke overenie skúseností ostatných používateľov môže pomôcť odhaliť nečakané komplikácie.

4. Skontrolujte požiadavky hostingu

Nová verzia Joomla nemusí fungovať na rovnakom serverovom prostredí ako pôvodná verzia. Overte najmä:

• PHP,
• MySQL, MariaDB alebo PostgreSQL,
• dostupné PHP moduly,
• pamäťový limit,
• maximálnu veľkosť nahrávaných súborov,
• čas vykonávania PHP skriptov,
• dostatok voľného miesta.

Podľa aktuálnej oficiálnej dokumentácie sú základné požiadavky takéto:

Pre Joomla 5 aj Joomla 6 sa odporúča PHP pamäťový limit aspoň 256 MB. Joomla 6 rozlišuje pri MariaDB absolútne minimum 10.4 a podporovanú verziu od 10.6.

Praktickým riešením je najskôr nastaviť na testovacej kópii takú verziu PHP, ktorú podporuje zdrojová aj cieľová verzia Joomla. Súčasne treba preveriť, či ju podporujú všetky dôležité rozšírenia.

5. Aktualizujte existujúcu inštaláciu

Pred veľkým upgrade by mala byť pôvodná stránka v čo najlepšom stave. Aktualizujte:

• Joomla na posledné vydanie aktuálnej vetvy,
• komponenty, moduly a pluginy,
• jazykové balíky,
• šablónu,
• framework šablóny,
• page builder,
• doplnkové knižnice.

Rozšírenia sa bežne aktualizujú cez administračnú časť Joomla. Systém však dokáže automaticky vyhľadať aktualizáciu iba vtedy, keď má rozšírenie správne nastavený aktualizačný server.

Po aktualizácii pôvodnej stránky skontrolujte frontend aj administráciu. Ak sa chyba objaví už v tejto fáze, nemá zmysel pokračovať k hlavnej verzii Joomla, kým ju neodstránite.

6. Preverte kompatibilitu všetkých rozšírení

Otvorte predaktualizačnú kontrolu v komponente Aktualizácia Joomla. Zobrazené výsledky rozdeľujú rozšírenia podľa toho, či sú pre cieľovú verziu označené ako kompatibilné, nekompatibilné alebo s neznámym stavom.

Stav „neznáma kompatibilita“ automaticky neznamená, že rozšírenie nebude fungovať. Často iba chýba príslušná značka v aktualizačných údajoch výrobcu. Predaktualizačná kontrola dokáže spoľahlivo vyhodnotiť iba rozšírenia, ktorých vývojár poskytuje aktualizačný server a údaje o kompatibilite.

Pre každé dôležité rozšírenie preto skontrolujte aj:

1. webovú stránku výrobcu,
2. dokumentáciu a zoznam zmien,
3. podporované verzie Joomla a PHP,
4. dostupnosť novšej verzie,
5. postup migrácie údajov.

Nepodporované rozšírenie treba aktualizovať, nahradiť alebo odstrániť. Nestačí ho iba vypnúť, pretože jeho súbory alebo databázové pluginy môžu ovplyvniť upgrade aj naďalej.

7. Skontrolujte šablónu a vlastné úpravy

Samostatnú pozornosť venujte:

• hlavnej šablóne,
• administračnej šablóne,
• frameworku, napríklad Helix Ultimate, Gantry alebo T4,
• page builderu,
• child template,
• súboru custom.css,
• vlastnému JavaScriptu,
• template overrides,
• upraveným jazykovým reťazcom.

Template override môže obsahovať kód skopírovaný zo starej verzie Joomla. Po upgrade sa síce stránka môže načítať, ale niektoré časti sa môžu zobrazovať nesprávne alebo prestanú fungovať.

Šablóna pritom neurčuje iba farby a vzhľad. Obsahuje štruktúru stránky, pozície modulov, skripty a spôsob zobrazovania dát z komponentov. Zmena kompatibility šablóny preto môže ovplyvniť menu, moduly aj hlavný obsah.

Kompatibilné pluginy pri veľkom upgrade

Pri prechode z Joomla 4 na Joomla 5 pomáha plugin Behaviour – Backward Compatibility, ktorý dočasne poskytuje časť staršieho kódu. Nemal by sa však považovať za trvalú náhradu aktualizácie rozšírení. Jeho vypnutie sa má najskôr skúšať na testovacej kópii.

Pri prechode z Joomla 5.4 na Joomla 6 predaktualizačná kontrola overuje správny stav pôvodného pluginu spätnej kompatibility a nového pluginu Behaviour – Backward Compatibility 6. Ak požadované kontroly neprejdú, živá aktualizácia na Joomla 6 sa nespustí.

8. Skontrolujte databázu

Pred upgrade otvorte v administrácii Joomla časť Systém – Informácie – Databáza alebo zodpovedajúcu položku údržby databázy.

Výsledkom by mala byť informácia, že štruktúra databázových tabuliek je aktuálna. Ak Joomla nájde rozdiel medzi programovými súbormi a databázovou schémou, ponúkne možnosť aktualizovať štruktúru.

Databázová kontrola vykonáva chýbajúce aktualizačné SQL skripty a opätovne preverí stav tabuliek. Pred veľkým upgrade by sa nemalo pokračovať, pokiaľ databáza hlási nevyriešené chyby.

Skontrolujte tiež, či databáza neobsahuje pozostatky veľmi starých rozšírení alebo predchádzajúcich migrácií. Neznáme položky však neodstraňujte bez zálohy a bez overenia ich pôvodu.

9. Vytvorte úplnú zálohu

Záloha musí obsahovať minimálne:

• všetky súbory Joomla,
• databázu,
• súbor configuration.php,
• skryté súbory, napríklad .htaccess,
• používateľské obrázky a dokumenty,
• vlastné skripty mimo hlavného priečinka,
• prípadné nastavenia cron úloh.

Zálohu uložte mimo servera, na ktorom sa nachádza produkčná stránka. Nestačí spoliehať sa iba na automatické zálohovanie hostingu.

Dôležité je tiež overiť, či sa záloha dá skutočne obnoviť. Joomla nepodporuje klasický downgrade, takže bezpečným návratom po neúspešnom upgrade je obnovenie súborov aj databázy zo zálohy vytvorenej bezprostredne pred zásahom.

10. Vytvorte testovaciu kópiu stránky

Veľký upgrade nikdy neskúšajte prvýkrát na produkčnej stránke. Vytvorte jej kópiu:

• na subdoméne,
• v staging prostredí hostingu,
• na lokálnom serveri,
• alebo v samostatnom hostingovom účte.

Testovacia stránka by mala používať rovnakú verziu PHP, databázy a podobné nastavenia servera ako budúca produkčná stránka. Zablokujte jej indexovanie vyhľadávačmi a odosielanie reálnych e-mailov zákazníkom.

Odborná literatúra k Joomla odporúča skopírovať súbory aj databázu do testovacieho prostredia, vykonať celý upgrade nanečisto a produkčnú stránku aktualizovať až vtedy, keď testovacia verzia funguje bez problémov. Odporúča tiež zvoliť čas s nízkou návštevnosťou a vopred informovať používateľov, ktorých sa odstávka týka.

11. Pripravte si testovací scenár

Ešte pred upgrade si spíšte, čo budete po jeho dokončení kontrolovať. Zamerajte sa najmä na:

• domovskú stránku a hlavné podstránky,
• menu a mobilnú navigáciu,
• články a kategórie,
• moduly a ich priradenie,
• kontaktné a registračné formuláre,
• prihlasovanie používateľov,
• vyhľadávanie,
• viacjazyčnosť,
• editor článkov,
• page builder,
• odosielanie e-mailov,
• SEO adresy a presmerovania,
• vlastné polia,
• naplánované úlohy,
• elektronický obchod alebo rezervačný systém.

Pri dôležitých stránkach si pred upgrade vytvorte snímky obrazovky. Po aktualizácii tak ľahšie odhalíte zmeny v rozložení, typografii alebo pozíciách modulov.

12. Pripravte plán návratu

Pred spustením produkčného upgrade musíte vedieť odpovedať na tieto otázky:

• Kde sa nachádza posledná úplná záloha?
• Ako dlho trvá jej obnovenie?
• Máte prístup k FTP alebo správcovi súborov?
• Máte prístup k databáze?
• Dokážete zmeniť verziu PHP?
• Viete stránku obnoviť aj bez prístupu do administrácie?
• Kto rozhodne, že sa upgrade zruší a obnoví sa záloha?

Určte si aj časový limit. Ak sa závažný problém nepodarí odstrániť napríklad do jednej hodiny, môže byť rozumnejšie obnoviť pôvodnú stránku a pokračovať v riešení na testovacej kópii.

13. Naplánujte produkčný upgrade

Upgrade vykonajte v čase najnižšej návštevnosti. Pri firemnom webe to môže byť večer alebo cez víkend, pri internetovom obchode sa riaďte skutočnými štatistikami návštevnosti a objednávok.

Tesne pred začiatkom:

1. zastavte úpravy obsahu,
2. informujte editorov a administrátorov,
3. zapnite režim offline,
4. vymažte starú vyrovnávaciu pamäť,
5. vytvorte poslednú úplnú zálohu,
6. overte veľkosť a dátum zálohy,
7. skontrolujte voľné miesto na serveri,
8. až potom spustite upgrade.

Pri stránkach s objednávkami, registráciami alebo používateľským obsahom musí byť obdobie medzi poslednou zálohou a spustením upgrade čo najkratšie.

Rýchly kontrolný zoznam pred kliknutím na Aktualizovať

• Poznám aktuálnu a cieľovú verziu Joomla.
• Zdrojová Joomla je aktualizovaná na požadovanú východiskovú verziu.
• Prečítal som si oznámenie o vydaní a známe problémy.
• Hosting spĺňa požiadavky cieľovej verzie.
• PHP je kompatibilné s Joomla aj rozšíreniami.
• Všetky rozšírenia sú aktualizované.
• Kompatibilitu potvrdili aj ich výrobcovia.
• Šablóna, framework a page builder podporujú cieľovú verziu.
• Skontroloval som template overrides a vlastný kód.
• Predaktualizačná kontrola nehlási nevyriešené problémy.
• Databázová štruktúra je aktuálna.
• Mám úplnú zálohu súborov a databázy.
• Obnovenie zálohy bolo overené.
• Upgrade úspešne prebehol na testovacej kópii.
• Mám pripravený testovací scenár.
• Poznám postup návratu k pôvodnej stránke.
• Produkčný upgrade je naplánovaný na vhodný čas.

Najčastejšie chyby pred upgrade

Spoliehanie sa iba na predaktualizačnú kontrolu

Kontrola v Joomla je veľmi užitočná, ale nemôže nahradiť informácie od výrobcov rozšírení. Chýbajúce údaje o kompatibilite môžu viesť k nesprávnemu pocitu bezpečia alebo k zbytočnému odkladu.

Upgrade priamo na živej stránke

Aj jednoduchý firemný web môže obsahovať starý plugin alebo override, ktorý sa na prvý pohľad nejaví ako problém. Testovacia kópia umožňuje chyby odstrániť bez výpadku produkcie.

Zmena všetkého naraz

Súčasná zmena Joomla, PHP, šablóny, page buildera a viacerých rozšírení sťažuje určenie príčiny chyby. Jednotlivé kroky je lepšie vykonávať postupne a po každom z nich stránku otestovať.

Neoverená záloha

Samotná existencia archívu ešte neznamená, že je záloha úplná. Chýbajúca databáza, poškodený archív alebo nesprávne prihlasovacie údaje sa často odhalia až pri pokuse o obnovenie.

Záver

Bezpečný upgrade Joomla stránky je výsledkom prípravy, nie šťastia. Najdôležitejšie je poznať technický stav webu, preveriť kompatibilitu rozšírení, vytvoriť obnoviteľnú zálohu a celý postup najskôr vyskúšať na testovacej kópii.

Samotná aktualizácia môže trvať iba niekoľko minút. Kontrola servera, šablóny, rozšírení a funkčnosti však rozhoduje o tom, či sa stránka po upgrade bez problémov vráti do prevádzky.