Biała strona w WordPress, często określana jako white screen albo white screen of death, najczęściej oznacza błąd PHP, konflikt wtyczek, problem z motywem albo brak wystarczającej pamięci PHP. Strona może wyglądać tak, jakby „zniknęła” — bez komunikatu błędu, bez treści i bez widocznych wskazówek.

W większości przypadków problem można zdiagnozować i naprawić poprzez włączenie debugowania, wyłączenie wtyczek, zmianę motywu, zwiększenie limitu pamięci lub sprawdzenie logów serwera. Najważniejsze jest ustalenie, co zmieniło się bezpośrednio przed pojawieniem się białej strony.

Problem

Strona WordPress wyświetla się jako całkowicie biała. Nie widać treści, menu, komunikatu błędu ani żadnego elementu strony. Czasami problem dotyczy całej witryny, a czasami tylko wybranej podstrony, panelu administratora albo frontu strony. To jeden z częstszych problemów technicznych w WordPressie. Jest szczególnie mylący, ponieważ użytkownik nie widzi żadnej informacji o tym, co poszło nie tak.

Najczęstsze objawy to:

• brak treści na stronie,
• brak komunikatu błędu,
• całkowicie białe tło,
• działa tylko panel administratora,
• działa tylko strona główna lub wybrane podstrony,
• problem pojawia się po aktualizacji albo instalacji wtyczki.

Najczęstsze przyczyny białej strony WordPress :

• błędy PHP,
• konflikt wtyczek,
• problem z motywem,
• brak pamięci PHP,
• błędy po aktualizacji,
• niekompatybilna wersja PHP,
• uszkodzone pliki WordPressa,
• błąd w indywidualnym kodzie strony.

W praktyce bardzo często problem pojawia się po aktualizacji wtyczki, zmianie motywu, dodaniu fragmentu kodu do functions.php albo instalacji nowego rozszerzenia.

Jak naprawić problem krok po kroku

Włącz debugowanie

Biała strona często ukrywa właściwy komunikat błędu. Włączenie debugowania pozwala zobaczyć, który plik, funkcja lub wtyczka powoduje problem.

Po tej zmianie WordPress powinien zapisywać błędy do pliku debug.log w katalogu /wp-content/. To bezpieczniejsze niż wyświetlanie błędów publicznie na stronie.

Jeśli po włączeniu debugowania pojawi się konkretny komunikat, sprawdź, czy wskazuje nazwę wtyczki, motywu albo pliku PHP.

Otwórz plik wp-config.php i dodaj lub zmień poniższe linie:

define(’WP_DEBUG’, true);

define(’WP_DEBUG_LOG’, true);

define(’WP_DEBUG_DISPLAY’, false);

Wyłącz wtyczki

Konflikt wtyczek to jedna z najczęstszych przyczyn białej strony. Jeśli nie masz dostępu do panelu WordPress, możesz wyłączyć je przez FTP lub menedżer plików hostingu.

Co zrobić:

• Połącz się z serwerem przez FTP lub panel hostingu.
• Przejdź do katalogu /wp-content/.
• Znajdź folder plugins.
• Zmień jego nazwę, np. na plugins_old.
• Odśwież stronę.

Jeśli strona zacznie działać, oznacza to, że problem powoduje jedna z wtyczek. Następnie przywróć nazwę folderu plugins i włączaj wtyczki pojedynczo, aby znaleźć tę odpowiedzialną za błąd.

Przełącz motyw

Motyw WordPress może powodować białą stronę, szczególnie jeśli zawiera błąd w pliku functions.php, nie jest zgodny z aktualną wersją WordPressa albo został niedawno zaktualizowany.

Jeśli masz dostęp do kokpitu, przejdź do Wygląd → Motywy i aktywuj motyw domyślny, np. Twenty Twenty-Four. Jeśli panel administratora nie działa, możesz tymczasowo zmienić nazwę folderu aktywnego motywu przez FTP. Jeżeli po zmianie motywu strona zaczyna działać, problem leży najprawdopodobniej w aktualnym motywie lub jego indywidualnych modyfikacjach.

Zwiększ pamięć PHP

Biała strona może pojawić się wtedy, gdy WordPress przekroczy dostępny limit pamięci PHP. Dotyczy to szczególnie większych stron, sklepów WooCommerce, rozbudowanych motywów i witryn z wieloma wtyczkami.

Otwórz plik wp-config.php i dodaj przed linią /* That’s all, stop editing! */:

define(’WP_MEMORY_LIMIT’, '256M’);

W przypadku, gdy wpisany kod nie przyniesie oczekiwanych skutków można spróbować dodać na górze pliku .htaccess kod:
php_value memory_limit 256M

Jeśli hosting ma ustawiony niższy limit globalny, ta zmiana może nie wystarczyć. Wtedy trzeba zwiększyć pamięć PHP w panelu hostingu lub skontaktować się z administratorem serwera.

Sprawdź logi serwera

Jeśli biała strona nadal się pojawia, sprawdź logi błędów. To najpewniejszy sposób, aby znaleźć konkretną przyczynę problemu.

Co zrobić:

• Zaloguj się do panelu hostingu.
• Otwórz sekcję Logi, Error logs albo Logi PHP.
• Sprawdź wpisy z momentu wystąpienia problemu.
• Zwróć uwagę na nazwy plików, wtyczek, motywów i komunikaty typu Fatal error.

Logi często pokazują dokładnie, który plik powoduje błąd. Dzięki temu można szybciej naprawić problem bez zgadywania.

Najczęstszy scenariusz

Najczęściej biała strona pojawia się po instalacji lub aktualizacji wtyczki. Nowa wersja powoduje błąd PHP albo konflikt z innym elementem strony, a WordPress przestaje wyświetlać treść. Typowy scenariusz wygląda najczęściej tak: strona działa poprawnie, następnie wykonywana jest aktualizacja lub instalacja rozszerzenia, po czym witryna pokazuje tylko białe tło. W takiej sytuacji diagnostykę najlepiej zacząć od wyłączenia ostatnio zmienionej wtyczki.

Kiedy zgłosić się do profesjonalisty?

Warto zgłosić się do profesjonalisty szczególnie wtedy, gdy nie masz dostępu do plików strony lub logów błędów, przez co samodzielna diagnoza problemu jest utrudniona. Pomoc specjalisty będzie również wskazana, jeśli biała strona pojawia się regularnie, witryna ma znaczenie biznesowe albo działa na niej sklep WooCommerce, gdzie każda awaria może wpływać na sprzedaż i obsługę klientów. Warto skorzystać ze wsparcia także wtedy, gdy debugowanie wskazuje na błędy w kodzie motywu lub wtyczki. W bardziej rozbudowanych projektach tzw. white screen często jest jedynie objawem głębszego problemu, na przykład konfliktu integracji, błędów PHP, ograniczeń serwera lub niekompatybilności między wersjami WordPressa, motywu i wtyczek.

Jeśli nie widać błędu, a strona nadal jest biała, warto dokładnie przeanalizować logi, konfigurację serwera i ostatnie zmiany na stronie. Przyczyna często nie jest widoczna na pierwszy rzut oka i może wynikać z konfliktu wtyczek, błędu PHP, motywu, limitów pamięci lub indywidualnych modyfikacji kodu.