Enable jQuery Migrate Helper

About Enable jQuery Migrate Helper

This plugin is designed to help your website run smoothly after updating to WordPress 5.5 or 5.6. It enables a migration script that allows older themes and plugins to continue functioning while their code is updated. However, it's recommended to fix the underlying issues causing compatibility problems rather than relying on the plugin long-term.

Frequently asked questions

What is the purpose of the Enable jQuery Migrate Helper plugin?

This plugin serves as a temporary solution to re-enable the jquery-migrate script, which was disabled by default in WordPress 5.5. It helps themes and plugins that rely on older jQuery code to function correctly.

Why might I need this plugin after WordPress 5.5?

After the WordPress 5.5 update, the jquery-migrate tool was no longer enabled by default, which could cause some themes or plugins using older code to have lacking functionality or unexpected behavior.

How does the plugin address changes in WordPress 5.6?

With the WordPress 5.6 update, the included jQuery version was upgraded, which means old code that previously caused warnings might now cause errors or stop working. The plugin allows you to downgrade to a previous jQuery version temporarily.

Is this a permanent solution for jQuery compatibility issues?

No, this plugin is a temporary solution. Site administrators are encouraged to get the underlying issues fixed in their themes and plugins.

Changelog

v 1.4.1 (2024-12-25)

Update jQuery version reference to match WordPress core.
Tested on latest WordPress core release.
Added some more urgency to the weekly reminder email if outdated jQuery versions are used, as they may not include the latest security patches.

v 1.4.0 (2023-07-31)

Fixed a bug where an empty error text would cause the plugin scripts from working properly.
Improved how inline scripts are detected and logged when applicable.
Improved logging to also capture deprecations within WordPress core.
Changed variable declarations for front-end scripts to use var instead of const and let, to improve compatibility for sites servicing older clients.
Updated the (modern) bundled jQuery Migrate script to match what is shipped with WordPress core.

v 1.3.0

Added legacy jQuery UI to be loaded if legacy jQuery is in use.
Added mention of site URLs in automatic emails.
Added option to enable/disable automatic downgrades.
Added logic to ensure only one downgrade request is sent per page load.
Updated logic around automatic downgrades for improved performance.
Fixed core deprecation notices being incorrectly labeled as undetermined inline ones.

v 1.2.0

Added settings page
Added option for downgrading to legacy jQuery
Added automatic downgrades
Added option to log deprecations in modern jQuery
Added e-mail notifications
Added weekly email digest of deprecations
Added option to allow logging deprecations from anonymous site visitors
Changed the handling of inline JavaScript code causing deprecation notices
Changed the admin bar to be two fixed links to avoid ever changing contexts
Changed the admin notices to be persistent when using legacy jQuery after upgrading to WordPress 5.6
Changed how concatenation is disabled, to address public-facing performance concerns
Fixed recommendation to remove plugin when not logging any deprecations having the wrong logic and not being displayed.

v 1.1.0

Added option to dismiss deprecation notices in backend
Added logging of deprecation notices in the front end
Added admin bar entry to show when deprecations occur
Added view of logged deprecations
Added dashboard notice encouraging users to remove the plugin if no deprecations have been logged in a while (1 week).
Changed the time interval between showing the dashboard nag from 2 weeks to 1 week, as WordPress 5.6 comes closer.

v 1.0.1

Fix one of the admin notices being non-dismissible.

v 1.0.0

Initial release.