Як допомогти з налагодженням плагінів WordPress

Розробники JoomUnited завжди працюють над тим, щоб ваші плагіни працювали якомога оптимальніше. Звісно, у деяких випадках можуть виникати певні збої, наприклад, несумісність, спричинена стороннім плагіном. А чого ми хочемо, коли трапляються такі збої? Звісно ж, щоб їх швидко вирішували ...    

У цій статті ми навчимо вас, як надати розробнику правильну інформацію, щоб він міг швидко зрозуміти та вирішити помилку. Цю статтю буде розділено на 3 кроки, яких ми дотримуватимемося, щоб надати розробнику правильну інформацію, коли виникає проблема:

• Увімкнути журнал налагодження
• Встановіть плагін для усунення несправностей
• Перевірте на наявність помилок JavaScript

Увімкнення системи налагодження та журналювання WordPress

Перш за все, нам потрібно знати, що таке WP_DEBUG ; Як ми бачимо у Вікіпедії, « WP_DEBUG — це PHP константа (постійна глобальна змінна), яка може використовуватися для активації режиму «налагодження» у всьому WordPress. За замовчуванням вважається, що вона має значення false, і зазвичай встановлюється в true у файлі wp-config.php на копіях WordPress для розробки.»

Як бачимо, WP_DEBUG — це константа, яка за замовчуванням вимкнена , але ми можемо її увімкнути для тимчасового налагодження. 

Крім того, існує ще одна PHP-константа під назвою WP_DEBUG_LOG , яка допоможе нам автоматично створити текстовий файл з усіма помилками ваших плагінів, і саме його ми надішлемо розробникам.  

Ми навчимо вас, як саме його увімкнути та як це виглядатиме, якщо з вашим плагіном виникне помилка, WP Meta SEO буде використано для цього прикладу, але ви можете виконати ті самі кроки для всіх наших плагінів. У цьому випадку у нас проблема з WP Meta SEO, це може бути будь-яка проблема, тому ми відкриємо файл wp-config.php , це можна зробити за допомогою вашого улюбленого текстового редактора, наприклад Notepad, Visual Studio Code, Brackets, просто відкрийте wp-config.php.

Файл розташовано в корені вашого сервера, де встановлено ваш вебсайт WordPress.

Відкрийте його в текстовому редакторі, а потім натисніть CTRL + F або натисніть Редагувати > Знайти… ви побачите поле, у яке можна ввести слово, яке ви збираєтеся знайти; у цьому випадку ми введемо «WP_DEBUG» і натискайте Enter, доки не знайдете:
«define( 'WP_DEBUG', false )»

Тепер, коли ми на цьому рядку, видаліть «false» і введіть true, натисніть Enter, а в наступному рядку скопіюйте define( 'WP_DEBUG_LOG', true ); і збережіть файл. Він має виглядати як на наступному зображенні.

Якщо ці два рядки змінити, у теці /wp-content/ з’явиться файл під назвою «debug.php»

І готово… ми завершили перший крок, це один із файлів, який знадобиться нашим розробникам, щоб прискорити процес вирішення вашої проблеми. Усі помилки буде відстежено та записано саме в цей текстовий файл.

Встановіть плагін усунення несправностей WordPress

Плагін Health Check & Troubleshooting — це плагін, який дозволяє запускати перевірку конфліктів без впливу на звичайних відвідувачів вашого сайту. Він дуже простий у використанні та встановленні. Для цього прикладу ми все ще будемо використовувати WP Meta SEO . Виконайте ці кроки, щоб встановити та запустити перевірку конфліктів за допомогою Health Check & Troubleshooting:  

• Увійдіть на свій сайт WordPress, ви опинитеся на панелі керування свого сайту
• Натисніть «Плагіни» в лівій частині вашої сторінки
• Натисніть «Додати новий»
• Введіть «Health Check & Troubleshooting» у рядку пошуку, як показано нижче

• Натисніть «Встановити зараз», список плагінів завантажиться автоматично, знайдіть потрібний і натисніть «Встановити зараз», а потім «Активувати»

• Натисніть «Стан сайту», у лівому меню є розділ «Інструменти» Натисніть на нього, а потім на «Стан сайту»

• Натисніть на вкладку «Усунення несправностей» , прочитайте попереджувальну інформацію та натисніть «Увійти в режим усунення несправностей» 

Режим усунення несправностей автоматично вимикає всі плагіни та перемикається на стандартну тему. Режим усунення несправностей не впливає на звичайних відвідувачів вашого сайту.  

• Відтворіть проблему, з якою ви зіткнулися

У типовому середовищі без активних плагінів і з типовою темою, якщо проблема виникає, це означає, що наш плагін не спричиняє неочікуваної поведінки.

• Натисніть «Плагіни» > «Встановлені плагіни»

  Меню «Плагіни» розгорнеться, надаючи вам додаткові параметри. Натисніть «Встановлені плагіни»

• Натисніть «Увімкнути під час усунення несправностей» поруч із WP Meta SEO

• Відтворіть проблему, з якою ви зіткнулися , коли активний лише WP Meta SEO і стандартна тема. Якщо проблема виникає, її спричиняє наш плагін.

Певною мірою це хороша новина, адже ви вже визначили одну частину проблеми. Тепер потрібно, щоб розробник увійшов на ваш сайт і виправив проблему, перш ніж ми випустимо нову версію! Якщо ні, повторіть кроки, щоб активувати наступний вимкнений плагін, доки ви зможете відтворити помилку.

Перевірка та налагодження помилок JavaScript у плагінах WordPress

Ми будемо шукати помилки JavaScript за допомогою консолі Chrome або Firefox. Залежно від вашого браузера її назва трохи відрізняється, але, за прикладом Chrome і Firefox, ми називатимемо її «Консоль». Щоб відкрити консоль, просто виконайте такі кроки:  

• Клацніть правою кнопкою миші на «Оглянути» у зовнішній частині сайту в будь-якому місці

• Виберіть консоль, відкриються інструменти розробника з правого боку сторінки, натисніть «Консоль»

Перевірте на наявність помилок, з відкритою консоллю відтворіть помилку, яку ви очікували, і подивіться на консоль, помилки — це червоні тексти, які описують, де знаходиться конфлікт javascript

Якщо ви знайшли помилку JavaScript, будь ласка, зробіть знімок екрана розгорнутої версії помилки, щоб додати його до вашого звернення/повідомлення.

Надішліть / поділіться звітом про вашу проблему

Тепер, коли у вас є вся ця інформація, ви допоможете розробнику прискорити процес — просто візьміть усю зібрану інформацію та додайте її до свого звернення/повідомлення. Нагадаймо, що ці пункти такі:  

• debug.log
• Примітка з плагінами, які спричиняють конфлікти
• Знімок консолі JavaScript із помилкою

Якщо ви виконаєте ці кроки та надішлете нам правильну інформацію, розробник зможе швидше виконати налагодження, і ми заздалегідь вам дуже вдячні :)    

Створення та надання нового облікового запису користувача WordPress для цілей підтримки

Створення нового адміністратора іноді є одним із швидких способів показати команді підтримки, у чому полягає ваша проблема. Перш ніж розпочати цей процес, коротке нагадування:

• Ми не зберігаємо старі облікові дані після вирішення проблеми (з міркувань безпеки)
• Рекомендуємо видаляти ті облікові записи адміністраторів, створені для цілей підтримки
• Уся інформація, яку ви надаєте нашій команді, захищена та залишатиметься конфіденційною

Щоб створити нового користувача, спочатку увійдіть на свій адміністративний сайт. Після успішного входу ви опинитеся на панелі керування WordPress.

Потім перейдіть у лівому меню до розділу Користувачі.

Після цього перейдіть до верхньої частини екрана, натисніть кнопку Додати новий або перейдіть до кнопки Додати новий у лівому меню.

Далі на вашому екрані з’явиться форма Додати нового користувача . Є 2 обов’язкові поля для заповнення інформації: Ім’я користувача, Електронна пошта.

У полі Пароль ви можете скористатися генератором випадкових паролів або встановити власний. А також можете позначити опцію Надіслати сповіщення користувачу , якщо хочете надіслати новому користувачу лист про його обліковий запис.

Після цього ви обираєте Роль для користувача у спадному списку. Це важливий крок для встановлення дозволів для користувачів на вашому сайті. «Адміністратор» є найвищим рівнем і надає користувачеві доступ до всіх функцій вашого вебсайту. Ви можете встановити інші ролі, якщо хочете обмежити доступ користувача.

Нарешті, натисніть кнопку Додати нового користувача внизу. Готово, удачі!