Как помочь с отладкой плагина 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 ); и сохраните файл, он должен выглядеть как на следующем изображении.

Если эти две строки изменены, файл с именем “debug.php” появится в /wp-content/

И всё… мы завершили первый шаг, это один из файлов, который понадобится нашим разработчикам, чтобы ускорить процесс решения вашей проблемы. Все ошибки будут отслеживаться и записываться в этот самый текстовый файл.

Установите плагин диагностики 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 мы будем называть ее «Консоль». Чтобы открыть консоль, просто следуйте этим шагам:  

• Правый клик на inspect на внешнем интерфейсе в любой части сайта

• Выберите консоль, Откроются инструменты разработчика в правой части страницы, нажмите на “Консоль”

Проверьте ошибки, с открытой консолью воспроизведите ошибку, которую вы ожидали, и взгляните на консоль, ошибки отображаются красным текстом, в котором описывается, где находится конфликт javascript

Если вы обнаружили ошибку JavaScript, пожалуйста сделайте снимок экрана расширенной версии ошибки, чтобы включить его в ваше обращение/сообщение.

Отправить / Поделиться отчетом о проблеме

Теперь, когда у вас есть вся эта информация, вы поможете разработчику ускорить процесс, просто возьмите всю информацию, которую вы собрали, и добавьте ее в свой тикет/пост, давайте вспомним, что необходимо:  

• debug.log
• Заметка с плагинами, вызывающими конфликты
• Скриншот консоли javascript с ошибкой

Если вы выполните эти шаги и отправите нам правильную информацию, разработчик сможет выполнить работу по отладке быстрее, и мы заранее благодарим вас :)    

Создайте и поделитесь новой учетной записью пользователя WordPress для целей поддержки

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

• Мы не храним старые учетные данные после решения проблемы (по соображениям безопасности)
• Мы рекомендуем удалить учетные записи администратора, созданные для целей поддержки
• Вся информация, предоставленная нашей команде, является безопасной и останется конфиденциальной

Чтобы создать нового пользователя, сначала войдите в свой административный сайт. После успешного входа вы окажетесь в панели управления Wordpress.

Затем вам следует перейти в левый Меню > Пользователи.

После этого перейдите к верхней части экрана, нажмите на Добавить новый кнопку или перейдите к Добавить новый кнопке в левом меню.

Далее, форма добавления нового пользователя появится на вашем экране. Есть 2 поля, которые необходимо заполнить: Имя пользователя, Эл. почта.

В поле Пароль вы можете использовать генератор случайных паролей или установить свой собственный. И вы можете отметить опцию Отправить уведомление пользователю, если хотите отправить новому пользователю письмо об их учетной записи.

Затем вы выбираете Роль для пользователя в выпадающем списке. Это важный шаг для установки разрешений для пользователей на вашем сайте. "Администратор" является наивысшим уровнем и дает пользователю доступ ко всем функциям вашего сайта. Вы можете установить другие роли, если хотите ограничить доступ пользователя.

Наконец, нажмите на кнопку Добавить нового пользователя внизу. Уже сделано, удачи!