Każdy, kto choć raz próbował znaleźć źródło tajemniczego błędu PHP na produkcyjnej stronie WordPress, zna to uczucie: grzebanie w pliku debug.log, przeszukiwanie tysięcy linii tekstu i próba odgadnięcia, który wpis jest tym właściwym. LiKoToN Debug Logs powstało właśnie po to, żeby to zmienić.
LiKoToN Debug Logs to lekka, nowoczesna wtyczka, która automatycznie zbiera logi z kilku źródeł naraz i prezentuje je w czytelnym, umożliwiającym filtrowanie widoku, bezpośrednio w kokpicie WordPressa.
Co loguje wtyczka?
- Błędy i ostrzeżenia PHP: w tym błędy krytyczne, deprecjacje i błędy parsowania
- Błędy WordPressa (
wp_error_added) - Żądania REST API: trasa, metoda, parametry
- Zdarzenia logowania użytkowników
- Logi niestandardowe dodawane z poziomu własnego kodu przez
Likoton_Debug_Logs_Logger::log()
Wtyczka wspiera pełną listę poziomów logowania zgodną ze standardem PSR-3 oraz rozszerzoną o poziomy typowe dla PHP: debug, info, notice, warning, error, critical, alert, emergency, deprecated, user_deprecated, strict, parse, core_error, core_warning, compile_error, compile_warning, recoverable_error, user_error, user_warning, user_notice.
Podgląd logów – wygodny i szybki
Panel logów to serce wtyczki:
- Filtrowanie AJAX na żywo, bez przeładowania strony
- Nieskończone przewijanie (infinite scroll) zamiast paginacji
- Sortowanie po stronie klienta
- Filtry: wyszukiwanie tekstowe, poziom, źródło, ostatnie X logów
- Kolorowe odznaki ułatwiające szybkie rozróżnienie poziomów ważności
- Responsywna tabela – wygodna również na mniejszych ekranach
Tryb ciemny
Wtyczka oferuje przełącznik trybu ciemnego w stylu zapowiadanym dla WordPressa 7, działający na wszystkich stronach wtyczki. Świetna wiadomość dla programistów pracujących wieczorami.
Eksport do CSV
Jednym kliknięciem można wyeksportować wszystkie logi do pliku CSV, z osobnymi kolumnami dla czasu UTC (created_at_utc) oraz czasu lokalnego (created_at_local). Operacja jest zabezpieczona nonce’em i sprawdzeniem uprawnień.
Automatyczne czyszczenie
Logi potrafią rosnąć w nieskończoność. LiKoToN Debug Logs korzysta z WP-Cron do automatycznego czyszczenia starych wpisów zgodnie z ustawionym okresem retencji, od 30 minut do miesiąca, a przy okazji optymalizuje tabelę w bazie danych.
Ustawienia dopasowane do potrzeb
W panelu ustawień można:
- włączyć lub wyłączyć tryb ciemny,
- ustawić okres retencji logów,
- wybrać uprawnienie (capability) wymagane do przeglądania logów,
- zdecydować, które poziomy logów mają być widoczne w podglądzie,
- korzystać z automatycznego zapisu ustawień przez AJAX z powiadomieniem toast
Dla programistów
Wtyczka udostępnia prosty interfejs API do logowania własnych zdarzeń bezpośrednio z kodu:
Likoton_Debug_Logs_Logger::log( 'info', 'custom_source', 'Coś się wydarzyło', [ 'extra' => 'data' ] );To rozwiązanie idealne do wpinania własnej logiki logowania w motywach czy innych wtyczkach. Nie jest konieczne budowanie własnego systemu od zera.
Multisite? Bez problemu
Wtyczka w pełni wspiera instalacje typu multisite. Każda witryna w sieci ma własną, niezależną tabelę logów.
Bezpieczeństwo i wydajność
Logi trafiają do dedykowanej tabeli w bazie danych. Dzięki temu zapis odbywa się szybko i nie obciąża strony. Dostęp do logów można ograniczyć konkretnym uprawnieniem, a eksport CSV jest chroniony mechanizmem nonce.
Podsumowanie
LiKoToN Debug Logs to wtyczka stworzona z myślą o programistach i administratorach, którzy potrzebują szybkiego, przejrzystego wglądu w to, co dzieje się „pod maską” WordPressa, bez konieczności ręcznego przeszukiwania plików logów.
Wypróbuj wtyczkę: wordpress.org/plugins/likoton-debug-logs
Kod źródłowy na GitHubie: github.com/likot180/likoton-debug-logs