Spis treści

Czym jest Debug Bar i do czego służy

Debug Bar to klasyczna wtyczka developerska, która dodaje w górnym pasku administracyjnym WordPress nowe menu z podglądem zapytań, cache i innych informacji przydatnych podczas diagnozowania błędów. Po włączeniu WP_DEBUG wtyczka przechwytuje ostrzeżenia i notyfikacje PHP, a z SAVEQUERIES pokazuje także wszystkie zapytania do bazy wraz z czasem wykonania. Dzięki temu szybko sprawdzisz, co dzieje się w danym żądaniu strony bez wchodzenia w logi serwera.

Najważniejsze funkcje w pigułce

Panel w pasku administracyjnym z informacjami o bieżącej stronie: zapytania SQL, cache, szczegóły żądania i stan WordPress Query.
Obsługa trybu debugowania WordPress – rejestrowanie ostrzeżeń i notyfikacji PHP przy włączonym WP_DEBUG.
Podgląd wszystkich zapytań do bazy i ich czasu wykonania przy włączonym SAVEQUERIES – pomocny przy optymalizacji powolnych podstron.
Lekka architektura i możliwość rozbudowy poprzez liczne dodatki Debug Bar Console, Transients, Cron i wiele innych.

Wersja, zgodność i aktywne instalacje

W katalogu widnieje wydanie 1.1.7, informacje o aktualizacji z 11 lipca 2025 i około 20 tys. aktywnych instalacji. To sygnał, że projekt wciąż jest utrzymywany i działa z aktualnymi odsłonami WordPress.

Instalacja i szybka konfiguracja

Zainstaluj i aktywuj wtyczkę z repozytorium WordPress.
Włącz tryb debugowania w pliku wp-config.php, dodając linie:
define( 'WP_DEBUG', true );
define( 'SAVEQUERIES', true );
Pierwsza linia uruchamia logikę wyłapywania ostrzeżeń i notice’ów, druga – logowanie zapytań do bazy, które Debug Bar zobrazuje w panelu.
Odśwież dowolną stronę w panelu lub na froncie – w pasku administracyjnym zobaczysz nowe menu Debug. Kliknij, aby otworzyć panele diagnostyczne.

Jak czytać panele Debug Bar

Zapytania SQL – lista wszystkich zapytań z czasem wykonania i sumarycznymi statystykami. Kluczowe przy szukaniu wolnych wtyczek i szablonów.
Cache – informacje z systemu cache obiektów, pomocne przy analizie trafień i chybionych odczytów.
PHP Warnings i Notices – skondensowany widok błędów i ostrzeżeń z bieżącego żądania, co ułatwia wychwytywanie regresji.
Request i WP_Query – jak WordPress sparsował adres, jakie reguły rewrite zadziałały i jaki jest główny obiekt zapytań. To przydaje się przy diagnozie 404 lub konfliktów z niestandardowymi typami treści.

Kiedy sięgnąć po dodatki

Debug Bar Console – interaktywna konsola PHP i SQL w przeglądarce, przyspiesza testowanie krótkich fragmentów kodu.
Debug Bar Cron – inspekcja zadań cron i ich harmonogramu.
Debug Bar Transients – podgląd przejściowych danych, z opcją usuwania wybranych wpisów.
Actions and Filters Addon – lista akcji i filtrów przypiętych do bieżącego żądania wraz z priorytetami.
Post Types, Remote Requests, Shortcodes, Constants – tematyczne panele ułatwiające przegląd rejestracji typów treści, żądań zewnętrznych, shortcode’ów i stałych konfiguracyjnych.
Integracje branżowe – np. panel do ElasticPress, który pokazuje zapytania wyszukiwarki.

Debug Bar czy Query Monitor

Debug Bar jest lżejszy i prostszy, a jego funkcje można stopniowo poszerzać dodatkami. Query Monitor daje szerszy przekrój metryk out of the box, ale bywa bardziej rozbudowany. W praktyce Debug Bar sprawdza się, gdy chcesz szybki wgląd w zapytania, cache i błędy bez nadmiaru informacji.

Przykładowe scenariusze użycia

Powolna strona kategorii – włącz SAVEQUERIES, otwórz panel zapytań i zidentyfikuj najdłużej trwające SELECTy. Często winowajcą jest zapytanie złożone przez filtr wtyczki lub zagnieżdżone pętle w szablonie.
Niestabilne działanie po aktualizacji – przejdź do panelu ostrzeżeń PHP, sprawdź nowe notice’y i deprecated funkcje. Szybciej dojdziesz do pliku i linii, które wymagają poprawki.
Audyt hooków – zainstaluj Actions and Filters Addon i zobacz, które funkcje wpina dany motyw i w jakiej kolejności. Pomaga to rozplątać konflikty filtrów.
Korekta cache obiektów – porównaj liczniki odczytów i zapisów, aby ocenić skuteczność własnego cache’owania.

Dobre praktyki konfiguracji

Pracuj na środowisku testowym – włączaj WP_DEBUG i dodatki debugowe z dala od produkcji.
Używaj stałych warunkowo – możesz włączać SAVEQUERIES tylko dla administratorów lub w środowisku deweloperskim, aby uniknąć narzutu w produkcji.
Łącz z logami – Debug Bar świetnie nadaje się do oglądu żądania, a logi serwera lub debug.log dopowiadają kontekst historyczny.
Pamiętaj o czyszczeniu – po zakończeniu diagnozy wyłącz SAVEQUERIES i odinstaluj nieużywane dodatki, aby nie mnożyć punktów wycieku danych.

Typowe problemy i ich rozwiązania

Nie widzę menu Debug – upewnij się, że jesteś zalogowany i masz włączony pasek administracyjny na froncie.
Brak listy zapytań – sprawdź, czy stała SAVEQUERIES jest ustawiona na true w wp-config.php.
Puste panele błędów – weryfikuj, czy WP_DEBUG jest aktywne i czy błąd dotyczy aktualnie renderowanej strony.
Zbyt dużo informacji – zainstaluj tylko te dodatki, których potrzebujesz, albo rozważ Query Monitor jeśli wolisz jeden panel zawierający większość metryk.

Alternatywy i uzupełnienia

Poza Query Monitor istnieją wtyczki włączające i wyświetlające logi oraz konfiguracje debugowania, ale Debug Bar często wygrywa minimalizmem. W materiałach społeczności i dostawców hostingu znajdziesz przykłady użycia do szybkiej diagnozy wydajności i błędów – narzędzie jest powszechnie rekomendowane jako pierwszy krok w rozwiązywaniu problemów.

Podsumowanie

Debug Bar daje szybki, kontekstowy wgląd w to, co robi WordPress w ramach pojedynczego żądania. Dzięki opcjom WP_DEBUG i SAVEQUERIES oraz bogatym dodatkom, wtyczka pokrywa najczęstsze zadania diagnostyczne – od wolnych zapytań, przez błędy PHP, po analizę hooków. Jeśli chcesz lekkiego narzędzia, które dorasta do potrzeb wraz z dodatkami, Debug Bar będzie trafionym wyborem.

Debug Bar – centrum diagnostyki WordPress