Podczas pracy z WordPress, rozwiązywanie problemów może być czasami trudne. Na szczęście WordPress ma wbudowane narzędzie debugowania, które pomaga zlokalizować i rozwiązać problemy. Ten przewodnik pokaże krok po kroku, jak włączyć tryb debugowania WordPress.

Czym jest tryb debugowania WordPress?

Tryb debugowania WordPress to funkcja, która wyświetla błędy, ostrzeżenia i powiadomienia bezpośrednio na ekranie podczas pracy z witryną. Jest to niezwykle przydatne narzędzie do diagnozowania problemów z motywami, wtyczkami lub z rdzeniem WordPress.

Przy domyślnych ustawieniach WordPress ukrywa te komunikaty, aby nie zakłócać doświadczenia użytkownika. Włączenie trybu debugowania pokazuje te komunikaty, co pomaga w identyfikacji i rozwiązywaniu problemów.

Włączanie trybu debugowania (metoda 1): edycja wp-config.php

Najprostszym sposobem włączenia trybu debugowania WordPress jest edycja pliku wp-config.php. Ten plik znajduje się w głównym katalogu instalacji WordPress.

Oto kroki:

1. Połącz się z serwerem przez FTP lub panel hostingu
2. Znajdź plik wp-config.php w głównym katalogu WordPress
3. Pobierz plik i otwórz go w edytorze tekstu
4. Znajdź linię, która mówi: define('WP_DEBUG', false);
5. Zmień ją na: define('WP_DEBUG', true);
6. Zapisz zmiany i prześlij plik z powrotem na serwer

Jeśli nie możesz znaleźć linii define('WP_DEBUG', false);, dodaj poniższy kod tuż przed linią, która mówi /* That’s all, stop editing! Happy blogging. */:

define( 'WP_DEBUG', true);

Rozszerzona konfiguracja debugowania

Samo włączenie WP_DEBUG wyświetli wszystkie błędy, ostrzeżenia i powiadomienia bezpośrednio na stronie. Możesz jednak skonfigurować debugowanie bardziej szczegółowo:

Rejestrowanie błędów do pliku

Zamiast wyświetlać błędy na ekranie (co nie jest zalecane na stronie produkcyjnej), możesz zapisywać je do pliku dziennika:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);

Ta konfiguracja:

• Włącza debugowanie WordPress (WP_DEBUG)
• Zapisuje wszystkie błędy do pliku wp-content/debug.log (WP_DEBUG_LOG)
• Zapobiega wyświetlaniu błędów na stronie (WP_DEBUG_DISPLAY)
• Dodatkowo wyłącza wyświetlanie błędów PHP

Debugowanie skryptów

WordPress zawiera również opcję debugowania skryptów. Domyślnie WordPress ładuje zminimalizowane wersje plików JavaScript. Włączenie tej opcji powoduje ładowanie niezminimalizowanych wersji, co pomaga w debugowaniu:

define('SCRIPT_DEBUG', true);

Włączanie trybu debugowania (metoda 2): wtyczka

Jeśli nie czujesz się komfortowo edytując pliki konfiguracyjne, możesz użyć wtyczki, która pozwala włączyć debugowanie z poziomu panelu administracyjnego:

1. Zainstaluj i aktywuj wtyczkę „WP Debugging„
2. Wtyczka zacznie od razu działać
3. Ustawi następujące parametry:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );

Wszystkie błędy, powiadomienia i ostrzeżenia będą zapisywane w pliku dziennika. Masz do nie go dostęp na górnej, czarnej, belce WordPress pod nazwą „Debug Quick Look”.

Po zakończenie debugowania nie zapomnij wyłączyć wtyczki.

Kiedy wyłączyć tryb debugowania

Tryb debugowania powinien być włączony tylko podczas opracowywania lub rozwiązywania problemów z witryną. Na stronie produkcyjnej dostępnej publicznie zawsze wyłączaj tryb debugowania z następujących powodów:

1. Wydajność – tryb debugowania może spowalniać witrynę
2. Bezpieczeństwo – komunikaty błędów mogą ujawniać informacje o strukturze witryny
3. Doświadczenie użytkownika – komunikaty o błędach mogą być mylące dla odwiedzających

Podsumowanie

Tryb debugowania WordPress to potężne narzędzie do identyfikacji i rozwiązywania problemów z twoją witryną. Pamiętaj, aby zawsze wyłączać go na witrynach produkcyjnych po zakończeniu rozwiązywania problemów.

Jeśli pracujesz z deweloperem lub szukasz pomocy na forach wsparcia, informacje z trybu debugowania mogą być nieocenione w znalezieniu rozwiązania problemu.

Nie czujesz się na siłach, aby zrobić to samemu? Napisz do mnie a chętnie pomogę!