Описание
С обновлением WordPress 5.5 инструмент миграции, известный как jquery-migrate
, больше не включен по умолчанию. Это может привести к неожиданному поведению некоторых тем или плагинов, которые используют старый код.
Этот плагин служит временным решением, позволяя авторам плагинов и тем получить больше времени для обновления и тестирования своего кода.
С обновлением WordPress 5.6 обновляется также и поставляемая версия jQuery. Возможно что старый код, который ранее вызывал лишь предупреждения, теперь перестанет работать полностью или станет вызывать ошибки.
Впрочем, некоторые возможности могут просто перестать работать без последствий для функционала сайта.
Этот плагин позволяет использовать на сайте версию jQuery из предыдущих выпусков WordPress, в течении опредённого времени, чтобы дать вам возможность обновить плагины и темы использующие устаревший код (в.т.ч. сообщить их авторам о необходимости переписать код на более современный) или найти им замену. Вам не стоит рассматривать откат на старую версию jQuery как постоянное решение.
Установка
- Загрузите в папку плагинов, обычно
wp-content/plugins/
. - Активируйте плагин на экране плагинов.
- Вот и все! Плагин сделает все остальное автоматически за вас.
Часто задаваемые вопросы
-
Что означает что функция «устарела»?
-
Скрипт, файл или иной фрагмент кода считается устаревшим, когда разработчики заменяют его более современным или удаляют полностью.
-
Что изменилось в WordPress 5.6
-
С обновлением WordPress 5.6 обновляется также и поставляемая версия jQuery. Возможно что старый код, который ранее вызывал лишь предупреждения, теперь перестанет работать полностью или станет вызывать ошибки.
Этот плагин позволит при необходимости, вернуть старую версию jQuery (это также может произойти автоматически при определении использования старого кода). Что позволит вам выиграть еще больше времени до обновления или замены устаревших плагинов или темы. -
Как использовать консоль разработчика в браузере
-
На WordPress.org имеется статья (на английском) по использованию консоли браузера для диагностики ошибок JavaScript.
-
Плагин не записывает в журнал предупреждения об использовании устаревших функций или смену версии jQuery
-
При наличии на сайте плагинов, которые объединяют JS файлы или загружают их асинхронно (т.н. плагины оптимизации/минификации/конкатенации) этот плагин может не работать должным образом.
Если вашему сайту требуется для работы этот плагин, то отключите другие плагины вмешивающиеся в загрузку JavaScript (например перечисленных выше типов). Как только вы решите проблемы, вы сможете отключить этот плагин и снова использовать другие инструменты оптимизации JS.
-
Как мне понять нужен мне этот плагин или нет
-
Если что-то на вашем сайте перестало работать после обновления WordPress, то вы можете установить и активировать этот плагин. Если это поможет, то оставьте его включенным и следуйте инструкциям плагина (Вам следует идентифицировать источник проблемного кода, сообщить его авторам о необходимости обновления и ждать пока они это сделают, либо подыскать достойную замену для проблемного плагина или темы). Плагин сообщит вам о том, когда его можно будет удалить.
-
На сайте море предупреждений при использовании jQuery версии 3
-
jQuery версии 3 только начала использоваться в WordPress, это ожидаемо.
Предупреждения об использовании устаревших функций означают, что инструмент миграции работает по обеспечению совместимости старого кода до тех пор, пока код не будет обновлен. При этом функции сайта продолжают работать как прежде.
Отзывы
Участники и разработчики
«Enable jQuery Migrate Helper» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники«Enable jQuery Migrate Helper» переведён на 17 языков. Благодарим переводчиков за их работу.
Перевести «Enable jQuery Migrate Helper» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
v 1.4.1 (2024-12-25)
- Обновите ссылку на версию jQuery для соответствия ядру WordPress.
- Протестировано на последней версии ядра WordPress.
- Добавлена дополнительная срочность в еженедельное напоминание по электронной почте на случай использования устаревших версий jQuery, поскольку они могут не включать последние исправления безопасности.
v 1.4.0 (2023-07-31)
- Исправлена ошибка, из-за которой пустой текст ошибки приводил к неправильной работе скриптов плагина.
- Улучшено обнаружение и регистрация встроенных скриптов, если применимо.
- Улучшено ведение журнала, чтобы также фиксировать устаревание в ядре WordPress.
- Изменены объявления переменных для скриптов интерфейса для использования
var
вместоconst
иlet
, чтобы улучшить совместимость с сайтами, обслуживающими старые клиенты. - Обновлен (современный) встроенный скрипт jQuery Migrate для соответствия поставляемому с ядром WordPress.
v 1.3.0
- Добавлен устаревший пользовательский интерфейс jQuery, который будет загружен, если используется устаревший jQuery.
- Добавлено упоминание URL-адресов сайтов в автоматических письмах.
- Добавлена возможность включения/отключения автоматического понижения версии.
- Добавлена логика, гарантирующая отправку только одного запроса на понижение версии за одну загрузку страницы.
- Обновлена логика автоматического понижения версии для повышения производительности.
- Исправлена ошибка, из-за которой уведомления об устаревании ядра неправильно помечались как неопределенные встроенные.
v 1.2.0
- Добавлена страница настроек
- Добавлена возможность перехода на устаревшую версию jQuery
- Добавлены автоматические понижения
- Добавлена возможность регистрации устаревших версий в современном jQuery.
- Добавлены уведомления по электронной почте
- Добавлен еженедельный дайджест по электронной почте об устаревших функциях
- Добавлена возможность разрешить регистрацию устаревших функций от анонимных посетителей сайта.
- Изменена обработка встроенного кода JavaScript, вызывающего уведомления об устаревании.
- Изменена панель администратора на две фиксированные ссылки, чтобы избежать постоянной смены контекста.
- Изменены уведомления администратора, чтобы они оставались постоянными при использовании устаревшего jQuery после обновления до WordPress 5.6.
- Изменен способ отключения конкатенации для решения проблем производительности, с которыми сталкиваются пользователи.
- Исправлена рекомендация удалить плагин, если не регистрируются какие-либо устаревшие версии, имеющие неправильную логику и не отображаемые.
v 1.1.0
- Добавлена возможность отклонить уведомления об устаревании в бэкэнде
- Добавлено ведение журнала уведомлений об устаревании во внешнем интерфейсе.
- Добавлена запись в админ-панель для отображения случаев устаревания.
- Добавлен просмотр зарегистрированных устаревших функций
- Добавлено уведомление на панель управления, призывающее пользователей удалить плагин, если в течение некоторого времени (1 неделя) не было зарегистрировано ни одного случая его устаревания.
- Изменен временной интервал между отображением уведомления на панели управления с 2 до 1 недели в связи с приближением выхода WordPress 5.6.
v 1.0.1
- Исправлена ошибка, из-за которой одно из уведомлений администратора было невозможно закрыть.
v 1.0.0
- Первый выпуск.