Spis treści
Czym jest WP Mail Logging i po co go używać
WP Mail Logging to wtyczka, która zapisuje szczegółowe logi wszystkich wiadomości wysyłanych z WordPress. Dzięki temu natychmiast zobaczysz, czy e-mail został wygenerowany, przez jaki hook, do kogo trafił, jaki miał temat i jaką odpowiedź zwrócił mechanizm pocztowy. W praktyce to czarna skrzynka do diagnozowania problemów typu brak maili z formularzy, nieprzychodzące powiadomienia WooCommerce czy losowe opóźnienia. W redakcjach i sklepach internetowych logi pozwalają odtworzyć przebieg komunikacji oraz szybciej rozwiązać reklamacje.
Jak działa rejestrowanie wiadomości
Wtyczka przechwytuje wywołania funkcji wp_mail i zapisuje metadane wiadomości w bazie danych. Domyślnie loguje: datę i godzinę wysyłki, status, temat, nadawcę i odbiorców, nagłówki, treść w formacie tekst/HTML, załączniki oraz ewentualny komunikat błędu. W widoku listy możesz filtrować i przeszukiwać logi po polach, a pojedynczy wpis otworzyć w trybie szczegółów. To przydatne, gdy musisz sprawdzić, którą dokładnie wersję wiadomości otrzymał klient lub jaki adres e-mail został użyty w danym momencie.
Instalacja i pierwsza konfiguracja
- Wtyczki – Dodaj nową – wyszukaj WP Mail Logging.
- Zainstaluj i włącz.
- W menu pojawi się sekcja z listą logów i ustawieniami.
Na starcie zdecyduj, czy chcesz logować treść wiadomości, czy tylko metadane. Logowanie pełnej treści ułatwia diagnostykę, ale zwiększa wrażliwość danych i rozmiar bazy. Warto też ustawić politykę retencji, aby starsze wpisy kasowały się automatycznie.
Co dokładnie znajduje się w logach
- znacznik czasu i identyfikator logu,
- status wysyłki i kod błędu, jeśli wystąpił,
- adresy To, Cc, Bcc, nadawcę From i Reply-To,
- temat wiadomości i nagłówki techniczne,
- treść w formacie HTML lub tekstowym,
- listę załączników wraz ze ścieżkami,
- informację o filtrach lub hookach modyfikujących zawartość.
Pamiętaj, że status “wysłano” oznacza jedynie poprawne przekazanie wiadomości do warstwy transportu, a nie dostarczenie do skrzynki odbiorcy. Dlatego logi najlepiej łączyć z wtyczką SMTP zapewniającą uwierzytelnienie i raporty.
Praca z listą logów: filtrowanie, wyszukiwanie, eksport
- filtruj po statusie, dacie lub adresie odbiorcy,
- szukaj po temacie i nadawcy,
- otwieraj szczegóły wpisu, aby skopiować surową treść,
- eksportuj wyniki do CSV, gdy potrzebna jest próbka dla wsparcia.
W większych zespołach ustal wspólną konwencję tematów i identyfikatorów w treści maili. To ułatwia późniejsze filtrowanie i łączenie rekordów.
Diagnozowanie typowych problemów z e-mailami
- Brak maili z formularza – jeśli w logach nie ma próby wysyłki, sprawdź wtyczkę formularzy. Jeśli jest błąd transportu, skonfiguruj SMTP.
- Wiadomości trafiają do spamu – przeanalizuj nagłówki i wdroż SPF, DKIM, DMARC po stronie domeny.
- Podwójne wysyłki – szukaj duplikatów w logach, wyklucz podwójne hooki lub konflikty wtyczek.
- Opóźnienia – porównaj znaczniki czasu i sprawdź WP-Cron. Rozważ crontab systemowy.
Integracja z SMTP i usługami dostarczania
Rejestrowanie wiadomości łącz z wdrożeniem SMTP lub API dostawcy transakcyjnych e-maili. WP Mail Logging potwierdzi, że WordPress wygenerował poprawny e-mail i pokaże treść, a warstwa SMTP zadba o uwierzytelnienie i metryki. Zsynchronizuj identyfikatory wiadomości w nagłówkach, aby łączyć log WordPress z dziennikami dostawcy.
Bezpieczeństwo danych i zgodność z RODO
- loguj treść tylko, gdy to konieczne,
- włącz retencję i automatyczne czyszczenie,
- ogranicz uprawnienia do logów dla zaufanych użytkowników,
- maskuj lub wyklucz wrażliwe pola,
- uwzględnij logi w polityce prywatności i rejestrze czynności,
- dbaj o backup i szyfrowanie bazy.
Wydajność i retencja w dużych serwisach
- ustaw retencję na 14-60 dni,
- zapisuj pełną treść tylko dla krytycznych scenariuszy,
- optymalizuj tabele i archiwizuj logi do CSV,
- przy bardzo dużej wysyłce rozważ zewnętrzne systemy logowania.
Funkcje przydatne w codziennej pracy
- zbiorcze czyszczenie logów,
- podgląd i pobieranie załączników,
- szybkie kopiowanie tematów i adresów,
- oznaczanie wpisów jako zamknięte.
W zespołach wsparcia linkuj ID konkretnego logu w opisie zgłoszenia, aby każdy mógł łatwo odtworzyć kontekst.
Checklist przed publikacją i po incydencie
- skonfiguruj SMTP i wyślij test,
- włącz logowanie metadanych i retencję,
- sprawdź scenariusze: rejestracja, reset hasła, zamówienie, powiadomienia,
- w razie problemu wykonaj eksport próbki i popraw konfigurację domeny,
- po incydencie usuń nadmiarowe logi z wrażliwą treścią.
Najczęstsze problemy i szybkie rozwiązania
- Log nie pojawia się – upewnij się, że wiadomość korzysta z wp_mail i że filtr nie wyklucza rejestrowania.
- Puste treści – włącz zapisywanie body tylko na czas diagnostyki.
- Ogromna tabela – skróć retencję, włącz rotację, zaplanuj czyszczenie przez WP-Cron.
- Błędy znaków – sprawdź UTF-8 i nagłówki Content-Type.
- Widoczne hasła – nie wysyłaj haseł e-mailem, usuń wrażliwe logi.
Kiedy rozważyć alternatywy lub dodatki
Jeśli potrzebujesz śledzenia dostarczenia, otwarć i kliknięć, dodaj wtyczkę SMTP lub usługę transakcyjną. WP Mail Logging pozostaje fundamentem – pokazuje, co WordPress naprawdę wygenerował i skraca drogę do rozwiązania awarii powiadomień.