Jak pomóc w debugowaniu wtyczek WordPress

Twórcy JoomUnited zawsze pracują nad tym, aby Twoje wtyczki działały w możliwie najbardziej optymalny sposób. Oczywiście w niektórych przypadkach może wystąpić jakiś rodzaj awarii, na przykład niezgodność generowana przez wtyczkę innej firmy. A czego chcemy, gdy dochodzi do tego typu awarii? Oczywiście, że są one szybko rozwiązywane...    

W tym poście nauczymy Cię, jak przekazać deweloperowi prawidłowe informacje, aby mógł szybko zrozumieć i rozwiązać błąd. Ten post zostanie podzielony na 3 kroki, które wykonamy, aby przekazać deweloperowi właściwe informacje, gdy wystąpi problem:

• Włącz dziennik debugowania
• Zainstaluj wtyczkę Troubleshooting
• Sprawdź błędy JavaScript

Włącz system debugowania i rejestrowania WordPress

Przede wszystkim musimy wiedzieć, czym jest WP_DEBUG ; Jak możemy przeczytać w Wikipedii: „ WP_DEBUG to stała PHP (trwała zmienna globalna), której można użyć do włączenia trybu „debugowania” w całym WordPressie. Domyślnie przyjmuje się, że ma wartość false, a zwykle ustawia się ją na true w pliku wp-config.php w kopiach deweloperskich WordPressa.”

Jak widać, WP_DEBUG to stała, która domyślnie jest wyłączona , ale możemy ją włączyć tymczasowo w celu debugowania. 

Ponadto istnieje jeszcze jedna stała PHP o nazwie WP_DEBUG_LOG , która pomoże nam automatycznie utworzyć plik tekstowy ze wszystkimi błędami Twoich wtyczek i to właśnie go wyślemy do deweloperów.  

Nauczymy Cię, jak dokładnie możemy go włączyć i jak to będzie wyglądać, jeśli wystąpi błąd w Twojej wtyczce, WP Meta SEO zostanie użyta w tym przykładzie, ale możesz wykonać te same kroki dla wszystkich naszych wtyczek. W tym przypadku mamy problem z WP Meta SEO, może to być dowolny problem, więc to, co zrobimy, to otworzymy plik wp-config.php , można to zrobić za pomocą preferowanego edytora tekstu, na przykład Notatnika, Visual Studio Code, Brackets, po prostu otwórz wp-config.php.

Plik znajduje się w katalogu głównym serwera, w którym zainstalowana jest Twoja witryna WordPress.

Otwórz go w edytorze tekstu, a następnie naciśnij CTRL + F lub kliknij Edycja > Znajdź… zobaczysz pole, w którym możesz wpisać szukane słowo; w tym przypadku wpiszemy „WP_DEBUG” i naciśniemy Enter, aż znajdziemy:
„define( 'WP_DEBUG', false )”

Teraz, gdy jesteśmy w tej linii, usuń „false” i wpisz true, naciśnij Enter, a w następnej linii skopiuj define( 'WP_DEBUG_LOG', true ); i zapisz plik. Powinno to wyglądać jak na następnym obrazku.

Jeśli te dwie linie zostaną zmienione, w katalogu /wp-content/ pojawi się plik o nazwie „debug.php”

I gotowe… ukończyliśmy pierwszy krok, to jeden z plików, których nasi deweloperzy będą potrzebować, aby przyspieszyć proces rozwiązywania Twojego problemu. Wszystkie błędy będą monitorowane i zapisywane w tym właśnie pliku tekstowym.

Zainstaluj wtyczkę WordPress Troubleshooting

Wtyczka Health Check & Troubleshooting to wtyczka, która pozwala przeprowadzić sprawdzanie konfliktów bez wpływu na zwykłych odwiedzających Twoją witrynę. Jest naprawdę łatwa w użyciu i instalacji. W tym przykładzie nadal będziemy używać WP Meta SEO , aby zainstalować i uruchomić sprawdzanie konfliktów za pomocą Health Check & Troubleshooting:  

• Zaloguj się do swojej witryny WordPress, znajdziesz się w panelu administracyjnym swojej witryny
• Kliknij „Wtyczki” w lewej sekcji strony
• Kliknij „Dodaj nowy”
• Wpisz „Kontrola stanu zdrowia i rozwiązywanie problemów” w pasku wyszukiwania, jak pokazano poniżej

• Kliknij „Zainstaluj teraz”, lista wtyczek załaduje się automatycznie, znajdź właściwą i kliknij „Zainstaluj teraz”, a następnie „Aktywuj”

• Kliknij „Stan witryny”, w lewym menu znajduje się sekcja o nazwie „Narzędzia” Kliknij ją, a następnie „Stan witryny”

• Kliknij zakładkę „Rozwiązywanie problemów” , przeczytaj informacje ostrzegawcze i kliknij „Wejdź w tryb rozwiązywania problemów” 

Tryb rozwiązywania problemów automatycznie wyłącza wszystkie wtyczki i przełącza na domyślny motyw. Tryb rozwiązywania problemów nie wpływa na zwykłych odwiedzających Twoją witrynę.  

• Odtwórz problem, który wystąpił

W domyślnym środowisku bez aktywnych wtyczek i z domyślnym motywem, jeśli problem wystąpi, oznacza to, że nasza wtyczka nie powoduje nieoczekiwanego zachowania.

• Kliknij „Wtyczki” > „Zainstalowane wtyczki”

  Menu „Wtyczki” rozwinie się, udostępniając dodatkowe opcje. Kliknij „Zainstalowane wtyczki”

• Kliknij „Włącz podczas rozwiązywania problemów” obok WP Meta SEO

• Odtwórz problem, którego doświadczałeś przy aktywnym tylko WP Meta SEO i domyślnym motywie; jeśli problem wystąpi, oznacza to, że jego przyczyną jest nasza wtyczka.

To w pewnym sensie dobra wiadomość, ponieważ zidentyfikowałeś już jedną część problemu. Teraz wymaga to, aby deweloper zalogował się do Twojej witryny i naprawił problem, zanim wydamy nową wersję! Jeśli nie, powtórz kroki, aby aktywować kolejną wyłączoną wtyczkę, przy której jesteś w stanie odtworzyć błąd.

Sprawdzanie i debugowanie błędów JavaScript we wtyczkach WordPress

Będziemy szukać błędów JavaScript za pomocą konsoli Chrome lub Firefox. W zależności od przeglądarki jej nazwa może się nieznacznie różnić, ale zgodnie z Chrome i FireFox będziemy ją nazywać „Konsolą”. Aby otworzyć konsolę, wykonaj następujące kroki:  

• Kliknij prawym przyciskiem myszy na opcję Zbadaj, w dowolnym miejscu witryny w interfejsie użytkownika

• Wybierz konsolę, spowoduje to otwarcie narzędzi deweloperskich po prawej stronie, kliknij „Konsola”

Sprawdź, czy nie ma błędów – mając otwartą konsolę, odtwórz błąd, którego się spodziewałeś, i spójrz na konsolę; błędy to czerwone teksty opisujące, gdzie znajduje się konflikt JavaScript

Jeśli znalazłeś błąd JavaScript, zrób zrzut ekranu rozwiniętej wersji błędu, aby dołączyć go do swojego zgłoszenia/postu.

Wyślij / udostępnij zgłoszenie problemu

Teraz, gdy masz już wszystkie te informacje, pomożesz deweloperowi przyspieszyć proces – po prostu dołącz wszystkie zebrane informacje do swojego zgłoszenia/postu. Pamiętajmy, że są to:  

• dziennik debugowania
• Notatka z wtyczkami powodującymi konflikty
• Zrzut konsoli JavaScript z błędem

Jeśli wykonasz poniższe kroki i prześlesz nam prawidłowe informacje, programista będzie mógł szybciej przeprowadzić debugowanie, a my z góry bardzo dziękujemy :)    

Utwórz i udostępnij nowe konto użytkownika WordPress do celów wsparcia

Utworzenie nowego użytkownika administratora to czasem szybki sposób, aby pokazać zespołowi wsparcia, na czym polega Twój problem. Zanim rozpoczniesz ten proces, krótkie przypomnienie:

• Nie przechowujemy starych danych logowania po rozwiązaniu problemu (ze względów bezpieczeństwa)
• Zalecamy usunięcie kont użytkowników administracyjnych utworzonych w celach wsparcia technicznego
• Wszystkie informacje udostępniane naszemu zespołowi są zabezpieczone i pozostaną prywatne

Aby utworzyć nowego użytkownika, najpierw zaloguj się do swojego panelu administracyjnego. Po pomyślnym zalogowaniu znajdziesz się w panelu WordPress.

Następnie należy przejść do menu po lewej stronie Menu > Użytkownicy.

Następnie przejdź do górnej części ekranu, kliknij przycisk Dodaj nowy lub przejdź do przycisku Dodaj nowy w lewym menu.

Następnie na ekranie pojawi się formularz Dodaj nowego użytkownika . Aby wypełnić informacje, wymagane są 2 pola: Nazwa użytkownika, adres e-mail.

W polu Hasło możesz użyć generatora losowych haseł lub ustawić własne. Możesz także zaznaczyć opcję Wyślij powiadomienie do użytkownika , jeśli chcesz wysłać nowemu użytkownikowi wiadomość e-mail dotyczącą jego konta.

Następnie wybierasz Rolę dla użytkownika w polu rozwijanym. Jest to ważny krok, aby ustawić uprawnienia dla użytkowników w Twojej witrynie. "Administrator" to najwyższy poziom i daje użytkownikowi dostęp do wszystkich funkcji Twojej witryny. Możesz ustawić inne role, jeśli chcesz ograniczyć dostęp użytkownika.

Na koniec kliknij przycisk Dodaj nowego użytkownika na dole. Gotowe, powodzenia!