🧰 Jakie funkcje znajdziesz w CU Debug Tool?

Nasza wtyczka to lekki, modularny pasek debugowania dla WordPressa, który wyświetla się na dole frontendu strony – wyłącznie dla administratorów. Gwarantujemy zero wpływu na użytkowników końcowych oraz ciemny, elegancki interfejs, który nie przeszkadza w pracy.

Znajdziesz tu 12 modułów do Twojej dyspozycji:

• Dumps – zamiennik var_dump() bez psucia layoutu.
• Log Viewer – podgląd i czyszczenie debug.log bez logowania przez FTP.
• ACF Fields – inspekcja pól ACF dla aktualnej strony (post fields, block fields oraz option fields).
• Hooks – wyszukiwarka callbacków przypiętych do hooków.
• Rewrites – testowanie reguł permalinków.
• Globals – zmienne środowiskowe, stałe, użyty szablon.
• Inspector – szybki podgląd opcji z bazy (get_option).
• Registry – zdarzenia Cron + „Shortcode Detective”.
• Assets – lista załadowanych skryptów i styli.
• Mails – przechwytywanie e-maili wysyłanych przez wp_mail().
• SQL Monitor – analiza zapytań do bazy (włączana na żądanie).
• Tools – flush rewrites, czyszczenie transientów, test e-mail.

🏁 Zanim zaczniesz – pierwsze uruchomienie

Aby móc pracować z wtyczką, zainstaluj ją i zdefiniuj w pliku wp-config.php następującą stałą:
define( 'CU_DEBUG’, true );

Od teraz pasek debuggera będzie pojawiał się na dole każdej podstrony (tylko na froncie, nie znajdziesz go w panelu administracyjnym). Pamiętaj, że wtyczka pokazuje się tylko zalogowanym administratorom!

🔍 Zakładka Dumps – debugowanie bez psucia strony

Dzięki wbudowanej funkcji cu_dump() możesz w dowolnym miejscu w kodzie użyć jej zamiast standardowego var_dump().
Dlaczego warto? Często irytujące jest wpisywanie var_dump w tagach <pre> – tutaj używasz tylko cu_dump(), a cała zawartość zmiennej trafia do dedykowanej zakładki. Dodatkowo przy każdej pozycji możesz sprawdzić, w której linii i w jakim pliku funkcja została wywołana.

To wygodne i czyste rozwiązanie. Jeśli zdarzy Ci się debugować na produkcji (wiemy, że się nie powinno, ale kto nigdy nie robił tego pod presją czasu, niech pierwszy rzuci kamieniem! 🥸), nikt poza Tobą nie zobaczy tych danych.

Uwaga: Jeśli zostawisz cu_dump() w kodzie przy włączonej wtyczce, nic złego się nie stanie.
Jednak jeśli wyłączysz lub usuniesz wtyczkę, pozostawiona funkcja spowoduje błąd krytyczny.
Zalecamy usuwanie wszystkich wywołań przed wdrożeniem kodu na produkcję!

🕵️‍♂️ Podgląd debug loga bez zaglądania do FTP? Dlaczego nie!

Zaglądanie do logów przez FTP bywa frustrujące. W naszej wtyczce zyskujesz możliwość podglądu pliku debug.log oraz jego szybkiego wyczyszczenia. Oczywiście, jeśli w witrynie wystąpi błąd krytyczny i strona w ogóle się nie załaduje, wtyczka również nie zadziała – wtedy nadal musisz skorzystać z FTP. Jeśli jednak chcesz wyłapać błędy, które nie kładą strony, lub sprawdzić wpisy z error_log(), jest to rozwiązanie idealne.

Aby korzystać z zakładki Log, upewnij się, że w wp-config.php masz następujące wpisy:

• define( 'WP_DEBUG’, true );
• define( 'WP_DEBUG_LOG’, true );
• define( 'WP_DEBUG_DISPLAY’, false );

🏗️ Podgląd danych z ACF – koniec z ręcznym dumpowaniem!

Zakładka ta jest podzielona na trzy moduły:

• Post Fields – dane z ACF dla grup pól z warunkiem „Post Type”.
• Block Fields – dane dla warunku „Block”.
• Option Fields – wszystkie pola dodane jako Options Page.

Moduły dostosowaliśmy do naszego stylu developmentu, co pozwala na ogromną oszczędność czasu. Działa to podobnie do zakładki Dumps, ale nie musisz nic wpisywać – od razu widzisz pola ACF, z których korzystasz przy budowie bloków czy podstron.

🌐 Globals – Twoja zakładka „must have”

To jedna z naszych ulubionych sekcji. Dzięki niej błyskawicznie sprawdzisz:

• Plik inicjujący: Dowiesz się, który plik odpowiada za treść strony, na której jesteś (np. front-page.php).
• Środowisko: Wersja WordPressa, język, strefa czasowa, struktura permalinków i rodzaj serwera.
• PHP Config: Najważniejsze ustawienia, takie jak memory_limit, time_limit, max_input_vars czy max_upload_size.
• Dane strony: ID, typ oraz slug aktualnej podstrony.
• Dane użytkownika: ID, login, e-mail i rola aktualnie zalogowanej osoby.
• Waga strony: Informacja o tym, ile zasobów zajmuje Twój WordPress.
• Szablon: Nazwa, wersja, autor i slug do tłumaczeń.
• Stałe wp-config: Szybko sprawdzisz, czy debug jest włączony, jaki environment type jest ustawiony, czy cache jest włączony, możesz też sprawdzić memory limit WordPressa i wiele więcej.
  

Wszystko to możesz sprawdzić ręcznie, ale po co tracić czas? Tutaj masz najważniejsze informacje w jednym miejscu.

Podoba Ci się ta wtyczka? Sprawdź ją na oficjalnej stronie wordpress.org!

⏱️ SQL Monitor – sprawdzaj zapytania wtedy, kiedy chcesz

Z założenia CU Debug Tool ma być lekkim narzędziem. Dlatego podgląd zapytań do bazy danych odbywa się na żądanie. Jeśli potrzebujesz tej funkcji, aktywujesz ją przyciskiem i od razu widzisz listę zapytań wraz z czasem ich wykonania.

✨ Pozostałe funkcje CU Debug Tool

To nie wszystko! Do Twojej dyspozycji oddajemy również:

• Hooks – sprawdź callbacki do wszystkich hooków wraz z ich priorytetami. Pod ikoną informacji znajdziesz najczęściej używane hooki, aby nie wpisywać ich ręcznie.
• Rewrites – podaj URL i sprawdź, która reguła go obsługuje.
• Inspector – wpisz dowolną opcję z bazy (get_option) i sprawdź jej zawartość.
• Registry – podgląd zdarzeń Crona oraz zdefiniowanych shortcodów (z informacją o pliku i linii kodu).
• Assets – lista skryptów i stylów ładowanych na podstronie bez zaglądania w konsolę przeglądarki.
• Mails – podgląd maili wysyłanych przez wp_mail() (wymaga odświeżenia strony).
• Tools – lista i czyszczenie transientów, przycisk „Flush Rewrites” oraz wysyłka testowego e-maila.
  

🤔 FAQ – Najczęściej zadawane pytania