Biały ekran po zmianie motywu WordPress zwykle oznacza błąd PHP albo konflikt nowego szablonu z wersją WordPressa, wtyczkami lub serwerem. Najszybciej odzyskasz dostęp przez FTP – zmień nazwę folderu aktywnego motywu w katalogu /wp-content/themes/. WordPress przestanie go ładować i spróbuje uruchomić dostępny motyw domyślny.
Zabezpiecz stronę przed naprawą
Przed edycją plików wykonaj kopię zapasową bazy danych i plików. Jeśli panel WordPressa nie działa, użyj kopii dostępnej w panelu hostingu. Gdy nie masz backupu, każdą zmianę wykonuj pojedynczo i zapisuj poprzednie nazwy plików oraz folderów.
Edycja przez FTP lub Menedżer plików jest bezpośrednią zmianą na serwerze. Błędna modyfikacja pliku wp-config.php albo usunięcie niewłaściwego katalogu może spowodować kolejną awarię.
Przed rozpoczęciem sprawdź też, czy biały ekran dotyczy całej witryny, czy tylko panelu /wp-admin/. Jeśli WordPress wysłał wiadomość o błędzie krytycznym, sprawdź skrzynkę administratora. Link do Recovery Mode może pozwolić wejść do kokpitu i wyłączyć wadliwy motyw bez pracy przez FTP.
Do bezpiecznego wykonania zmian potrzebujesz:
- klienta FTP albo Menedżera plików w panelu hostingu
- danych dostępowych do serwera i właściwego katalogu domeny
- kopii pliku przed każdą ręczną edycją
- edytora tekstu, który nie dodaje formatowania do plików PHP
Jak przywrócić stronę przez FTP?
Jeśli po zmianie motywu nie masz dostępu do kokpitu, zacznij od odpięcia tego motywu. Nie usuwaj folderu. Zmiana nazwy pozwala łatwo cofnąć operację.
- Połącz się z serwerem. Otwórz katalog instalacji WordPressa, a następnie przejdź do
wp-content/themes/. - Znajdź folder nowego motywu. Jego nazwa zwykle odpowiada nazwie szablonu, który został właśnie aktywowany.
- Zmień nazwę folderu. Możesz dopisać na końcu na przykład
-old, tak aby WordPress nie rozpoznał katalogu motywu. - Odśwież stronę i panel. Jeśli w instalacji znajduje się kompatybilny motyw domyślny, WordPress może aktywować go automatycznie. W przeciwnym razie odzyskasz przynajmniej możliwość dalszej diagnostyki.
- Sprawdź pliki nowego motywu. Jeśli strona wróciła, przyczyną jest najpewniej motyw, jego kod lub konflikt z innym komponentem.
Nie zmieniaj nazw wszystkich folderów w themes. Pozostaw dostępny przynajmniej jeden motyw domyślny. Po odzyskaniu panelu możesz aktywować go ręcznie w sekcji „Wygląd” i „Motywy”.
| Objaw | Prawdopodobna przyczyna | Działanie |
|---|---|---|
| Biały ekran pojawił się natychmiast po zmianie motywu | Błąd PHP lub niezgodność nowego motywu | Zmień nazwę jego folderu w wp-content/themes/ |
Nie działa strona ani /wp-admin/ |
Motyw zatrzymuje wykonywanie WordPressa | Użyj FTP lub Menedżera plików, aby wymusić zmianę motywu |
| W logu pojawia się ścieżka do pliku motywu | Błąd w functions.php albo innym pliku szablonu |
Cofnij ostatnią zmianę, zaktualizuj motyw lub zleć analizę kodu |
| Komunikat zawiera „Allowed memory size exhausted” | Przekroczony limit pamięci PHP | Zwiększ limit w wp-config.php i sprawdź konfigurację hostingu |
Włącz WP_DEBUG i sprawdź log
Jeśli zmiana nazwy folderu nie pomogła albo chcesz potwierdzić przyczynę, włącz logowanie błędów. Wykonaj kopię wp-config.php, otwórz plik w edytorze tekstu i dodaj poniższe ustawienia przed komentarzem kończącym konfigurację WordPressa:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );WP_DEBUG uruchamia debugowanie, a WP_DEBUG_LOG zapisuje komunikaty do pliku wp-content/debug.log. Wyłączenie WP_DEBUG_DISPLAY jest ważne na działającej stronie, ponieważ błędy nie pojawią się publicznie wraz ze ścieżkami do plików.
Zapisz plik, prześlij go na serwer i ponownie wywołaj stronę. Następnie otwórz wp-content/debug.log. Szukaj wpisów z nazwą motywu, pliku functions.php, komunikatem Fatal error, Parse error albo Allowed memory size exhausted. Po zakończeniu diagnostyki zmień wartości debugowania z powrotem na false albo usuń dodane linie.
Zwiększ limit pamięci PHP
Nowy motyw może wymagać większej ilości pamięci, szczególnie gdy korzysta z rozbudowanego kreatora, wielu funkcji lub dodatkowych wtyczek. W pliku wp-config.php możesz ustawić na przykład:
define( 'WP_MEMORY_LIMIT', '256M' );Wartość musi mieścić się w limitach narzuconych przez PHP i hosting. Jeśli serwer nie pozwala na jej zwiększenie, wpis w konfiguracji WordPressa nie wystarczy. Wtedy sprawdź ustawienia PHP w panelu hostingu albo poproś administratora o weryfikację limitu.
Jeżeli po zwiększeniu pamięci strona działa tylko chwilowo, nie traktuj tego jako pełnej naprawy. Log może wskazać motyw lub wtyczkę, która zużywa zbyt dużo zasobów.
Kiedy potrzebna jest pomoc programisty?
Zatrzymaj samodzielne zmiany, jeśli log wskazuje niekompatybilność kodu motywu z wersją PHP serwera, a aktualizacja szablonu nie rozwiązuje problemu. Podobnie postąp, gdy motyw zawiera rozbudowane modyfikacje, własny kod albo zależności od konkretnej wtyczki.
Programista może porównać pliki, poprawić błąd PHP i sprawdzić zgodność całego zestawu WordPress, motywu oraz wtyczek bez przypadkowego uszkodzenia działających elementów. Jeśli nie masz backupu, tym bardziej nie usuwaj plików i nie nadpisuj motywu bez kopii.
Po naprawie otwórz stronę główną, kilka podstron i panel administracyjny. Sprawdź formularze, funkcje zależne od motywu oraz log błędów. Dopiero gdy witryna działa poprawnie, usuń kopię wadliwego motywu lub przywróć jego folder pod pierwotną nazwą.
Przed edycją plików WordPress zawsze wykonaj kopię zapasową. Instrukcja dotyczy typowych błędów po zmianie motywu, ale nie zastępuje analizy konfiguracji konkretnego serwera ani kodu.
