Об обновлении jQuery в WordPress 5.5+

WordPress 5.5 перестал включать скрипт jQuery Migrate helper по умолчанию, а c выпуском WordPress 5.6 поставляемая версия jQuery будет обновлена ​​(с 1.12.4-wp до 3.5.1).

Для пользователей это значит то, что любой плагин или тема, которые ранее полагались на инструмент jQuery Migrate для правильной работы (из-за устаревшего кода или просто пропущенного обновления устаревших функций), теперь могут вести себя неожиданно.

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

Решение для WordPress 5.5

Для выпуска WordPress 5.5 был создан плагин под названием Enable jQuery Migrate Helper, который повторно включит jQuery Migrate на сайте, а также обеспечит ведение журнала, чтобы администраторы сайта были в курсе происходящего.

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

К сожалению, многие плагины и темы (на момент публикации, перед выпуском WordPress 5.6), все еще используют старый код, и возможно очень многие платные плагины и темы тоже, о которых мы не можем знать.

Решение для WordPress 5.6

С учетом вышеизложенного, плагин Enable jQuery Migrate Helper был обновлен для выпуска WordPress 5.6, он теперь обеспечивает временный переход на более раннюю версию устаревшего jQuery при необходимости.

Причина, по которой это считается временным решением, заключается в том, что старая версия jQuery больше не получает обновления безопасности и не будет исправлена ​​вручную, если произойдет что-либо, требующее её обновлений.

Возможности плагина

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

Журнал использования старых функций

Факт использования устаревших функций определяется при переходах по страницам сайта с активным плагином.

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

вернхяя панель администратора показывает зафиксированные предупреждения

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

Вы увидите как общее количество зафиксированных предупреждений, так и количество зафиксированных предупреждений на открытой странице (в том числе и на части сайта для посетителей, если вы включили отображение панели администратора у себя в профиле для всего сайта).

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

журнал зафиксированных предупреждений

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

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

Использование старой версии jQuery

Экран настроек плагина с выбором старой версии

На экране настроек есть возможность включить использование старой версии jQuery 1.12.4-wp, это также включит неубираемое предупреждение в консоли о том, что данная мера является лишь временным решением, и вам не стоит рассматривать это как решение проблемы с обновлением jQuery навсегда.

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

Автоматическая смена версии

Для технически не подкованных пользователей, которые установили плагин по указанию поддержки, например, возможна автоматическая смена версии jQuery на устаревшую, в случае если плагин определит, что каким-то плагином или темой используется устаревший код.

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

Это одноразовое событие, которое не повторится в случае ручной смены версии jQuery в настройках плагина.

Сообщения по электронной почте

Плагин периодически (раз в неделю) будет отсылать на адрес администратора сообщение со статусом сайта, что является побуждением к тому, чтобы проблемы на сайте решались, если были зафиксированы предупреждения — вы узнаете об этом, если же в течении недели фактов использования устаревшего кода зафиксировано не было, то плагин предложит деактивировать себя, возможно он вам больше не нужен 😉

письмо с журналом предупреждений за неделю
предупреждений за неделю не было

Количество установок плагина также позволяет собрать статистику о том, у какого количества пользователей наблюдаются проблемы связанные с обновлением jQuery в WordPress 5.5+

английская версия этой статьи.

Внимание: вы можете оставить комментарий обратной связи к этой статье.

Если данная статья показалась вам неполной или вы нашли неточности, оставьте нам сообщение используя форму ниже.

Также вы можете поучаствовать в составлении и дополнении документации на русском языке.
Подробнее тут.

Была ли эта статья полезной? Как мы можем улучшить её?