Rollback aktualizacji WordPress: jak cofnąć feralną wtyczkę bez utraty danych

Wyobraź sobie piątkowe popołudnie. Klikasz "Aktualizuj wszystkie" w panelu WordPress, odświeżasz sklep i widzisz biały ekran albo, co gorsza, całkowicie rozjeżdżony wygląd strony. Klienci próbują złożyć zamówienia, a Ty stoisz z telefonem w ręku i nie wiesz, od czego zacząć.

Pracuję z WordPress od ponad 13 lat i obsłużyłem ponad 120 projektów - widziałem ten scenariusz dziesiątki razy. Dobra wiadomość jest taka, że rollback aktualizacji WordPress to procedura, którą da się przeprowadzić w 15-30 minut, jeśli wiesz, co robisz. Ten artykuł pokazuje Ci dokładnie jak - od białego ekranu, przez znalezienie winowajcy, aż po decyzję, kiedy rollback wystarczy, a kiedy trzeba sięgnąć po pełny backup.

Najpierw: czy masz backup?

Zanim przejdę do rollbacku, muszę zapytać o kopię zapasową. Rollback plików wtyczki jest prosty. Problem pojawia się wtedy, gdy wtyczka przy aktualizacji zmieniła strukturę bazy danych - na przykład dodała nowe kolumny do tabel WooCommerce albo przeniosła dane w inne miejsce. Cofnięcie samych plików PHP nie odwróci tych zmian w bazie. W takim scenariuszu potrzebujesz backupu.

Jeśli backup masz - świetnie, czytaj dalej. Jeśli nie - zanim zaczniesz rollback, sprawdź, czy hosting tworzy automatyczne kopie (na LH.pl standardowo jest to snapshot dobowy). Więcej o tym, jak weryfikować kopie zapasowe, piszę w oddzielnym artykule o testowaniu backupu WordPress.

Scenariusz: biały ekran po aktualizacji, panel niedostępny

To najgorszy wariant - nie możesz się zalogować do WordPressa, bo frontend jest martwy. Działasz wtedy przez FTP lub menedżer plików hostingu.

Krok 1: Wyłącz wszystkie wtyczki przez FTP

Połącz się z FTP. Przejdź do katalogu wp-content/ i zmień nazwę folderu plugins na plugins-old. WordPress nie znajdzie żadnych wtyczek i wyłączy je wszystkie naraz. W 90% przypadków strona natychmiast wstaje.

Krok 2: Znajdź winowajcę

Zmień nazwę folderu z powrotem na plugins. Wejdź do panelu administratora (teraz powinien działać). Włączaj wtyczki po jednej, po każdej aktywacji odświeżaj frontend. Gdy strona znowu padnie - masz winowajcę.

Alternatywa: jeśli masz włączone WP_DEBUG, sprawdź plik /wp-content/debug.log. Znajdziesz tam dokładną nazwę pliku i numer linii, gdzie wystąpił błąd - to szybciej niż aktywowanie po kolei.

Metoda 1: WP Rollback - najszybsza droga dla wtyczek z repozytorium

Jeśli masz dostęp do panelu administratora i problem dotyczy wtyczki z oficjalnego repozytorium WordPress.org (WooCommerce, Yoast SEO, Contact Form 7, Rank Math i setki innych), WP Rollback to najwygodniejsze narzędzie.

Instalacja: Plugins > Dodaj nową > wpisz "WP Rollback" > Zainstaluj i aktywuj.

Użycie: Wejdź do Plugins > Zainstalowane wtyczki. Przy każdej wtyczce pojawi się nowy link "Rollback". Kliknij go przy feralnej wtyczce, wybierz poprzednią wersję z listy i potwierdź. Gotowe.

WP Rollback od wersji 2.x tworzy automatycznie lokalną kopię ZIP bieżącej wersji przed każdą aktualizacją - pliki trafiają do wp-content/uploads/wp-rollback/. To oznacza, że nawet jeśli nie masz zewnętrznego backupu wtyczki, możesz wrócić do poprzedniej wersji bez połączenia z internetem.

Metoda 2: ręczny rollback przez FTP

Ta metoda działa zawsze - niezależnie od tego, czy wtyczka jest z repozytorium, czy premium. Potrzebujesz: dostępu do FTP, archiwum ZIP ze starszą wersją wtyczki.

Skąd pobrać starszą wersję?

Dla wtyczek z WordPress.org: wejdź na stronę wtyczki, kliknij "Advanced View" (lub bezpośrednio wordpress.org/plugins/nazwa-wtyczki/advanced/), tam znajdziesz historię wersji z możliwością pobrania konkretnego ZIP.

Dla wtyczek premium: zaloguj się do konta na stronie dostawcy (np. WooCommerce.com, Gravity Forms, GeoWP). Większość dostawców udostępnia archiwum poprzednich wersji w panelu konta. Jeśli nie - skontaktuj się ze wsparciem.

Procedura:
1. Pobierz ZIP ze starszą wersją wtyczki.
2. Przez FTP wejdź do wp-content/plugins/.
3. Zmień nazwę folderu feralnej wtyczki na nazwa-wtyczki-backup (nie usuwaj - to Twoje zabezpieczenie).
4. Wgraj i rozpakuj ZIP ze starszą wersją (lub wgraj cały folder przez FTP).
5. Aktywuj wtyczkę w panelu WordPress.
6. Sprawdź, czy wszystko działa.
7. Dopiero po weryfikacji usuń folder z suffixem -backup.

Porównanie metod rollbacku

Dlaczego nie aktualizować wszystkiego naraz

To jeden z najczęstszych błędów, jakie widzę u właścicieli sklepów. Klikają "Aktualizuj wszystkie" i mają spokój. Do czasu.

Gdy po takiej zbiorowej aktualizacji coś pójdzie nie tak, nie wiesz, która wtyczka namieszała. Masz 15 zaktualizowanych elementów i musisz cofać po kolei lub metodą prób i błędów. Każda minuta to czas przestoju sklepu.

Prawidłowa kolejność aktualizacji to: najpierw rdzeń WordPress, potem motyw, na końcu wtyczki - i zawsze po jednej albo małymi grupami tematycznie powiązanych. Więcej o tym piszę w artykule o kolejności aktualizacji WordPress.

U jednego z moich klientów - sklep z produktami dla dzieci - zbiorowa aktualizacja ośmiu wtyczek jednocześnie wywołała błąd w generowaniu faktur. Znalezienie winowajcy zajęło dwie godziny, bo aktualizacje były przeprowadzone rano, a błąd faktury klient odkrył dopiero wieczorem przeglądając zamówienia. Gdyby aktualizował po jednej, mielibyśmy odpowiedź w pięć minut.

Co po rollbacku: nie zatrzymuj się na cofnięciu

Rollback to leczenie objawów, nie przyczyny. Strona działa, ale problem wciąż istnieje - bieżąca wersja wtyczki jest zepsuta i w każdej chwili może trafić do Ciebie lub do kogoś z Twoich klientów, jeśli przypadkowo kliknie aktualizację. Po cofnięciu feralnej wtyczki masz kilka konkretnych zadań.

Po pierwsze: sprawdź dziennik zmian wtyczki (changelog). Zazwyczaj znajdziesz go na stronie wtyczki w repozytorium WordPress.org w zakładce "Development" lub bezpośrednio w pliku readme.txt w katalogu wtyczki. Szukaj informacji o tym, co zmieniło się w feralnej wersji - to pomoże zrozumieć, czy problem leży po stronie wtyczki (błąd dewelopera), czy po stronie Twojego środowiska (konflikt z inną wtyczką, niekompatybilna wersja PHP).

Po drugie: zgłoś błąd. Jeśli to wtyczka z repozytorium WordPress.org, możesz zgłosić problem przez zakładkę "Support" na stronie wtyczki. Deweloperzy zazwyczaj reagują szybko, bo wpisy o błędach są widoczne publicznie. Przy wtyczkach premium skontaktuj się z supportem dostawcy.

Po trzecie: monitoruj nową wersję wtyczki. Zostaw tę wtyczkę na starszej wersji i czekaj, aż pojawi się aktualizacja, która naprawia zgłoszony błąd. Zanim ją zainstalujesz, sprawdź changelog - szukaj wpisów w stylu "fixed", "bugfix" lub opisu dokładnie tego problemu, który miałeś.

Kiedy rollback nie wystarczy i potrzebujesz przywrócić backup

Są sytuacje, kiedy rollback plików wtyczki nie rozwiąże problemu. Dzieje się tak, gdy:

• Aktualizacja zmieniła schemat bazy danych (migracja tabel). WooCommerce regularnie robi takie migracje przy dużych aktualizacjach. Cofnięcie plików PHP bez cofnięcia bazy danych skończy się błędami lub utratą danych.
• Wtyczka zapisała nowe dane w formacie niekompatybilnym ze starą wersją. Rollback zainstaluje starą wersję kodu, która nie będzie potrafiła odczytać nowych danych.
• Zepsuł się rdzeń WordPress, a nie wtyczka. W takim przypadku rollback samej wtyczki nic nie da.

W tych scenariuszach jedyną pewną drogą jest przywrócenie pełnego backupu - bazy danych i plików jednocześnie, do stanu sprzed aktualizacji. Dlatego powtarzam to do znudzenia: backup bazy przed każdą aktualizacją to absolutne minimum, nie opcja.

Zarządzanie aktualizacjami, backupami i reagowaniem na awarie to część tego, co wchodzi w skład opieki technicznej WordPress. Więcej o tym, co konkretnie obejmuje taka usługa i ile kosztuje, piszę w artykule o opiece WordPress.