Beschreibung
Mit der Aktualisierung auf WordPress 5.5 wurde ein Migrationstool namens jquery-migrate
standardmäßig nicht mehr aktiviert. Dies kann zu fehlender Funktionalität oder unerwartetem Verhalten in einigen Themes oder Plugins führen, die älteren Code ausführen.
Dieses Plugin dient als Übergangslösung. Das Aktivieren des Migrations-Skriptes auf deiner Website verschafft den Plugin- und Theme-Autoren mehr Zeit für das Aktualisieren und Testen ihres Codes.
Mit dem Update auf WordPress 5.6 wird auch die enthaltene Version von jQuery aktualisiert. Das bedeutet, dass alter Code, der früher Warnungen verursachte, nun stattdessen Fehler verursachen oder ganz aufhören kann zu funktionieren.
Einige der Funktionen, die nicht mehr funktionsfähig sind, werden hinter den Kulissen ohne offensichtliche Probleme nicht weiter ausgeführt.
Mit dem Plugin kannst du eine Zeit lang auf eine frühere Version von jQuery zurückstufen (Downgrade), aber als Website-Administrator wird dir empfohlen, das zugrunde liegende Problem zu beheben.
Installation
- Lade das Plugin in dein Plugin-Verzeichnis hoch, normalerweise
wp-content/plugins/
. - Aktiviere das Plugin in der Plugin-Ansicht.
- Das war’s! Den Rest erledigt das Plugin automatisch für dich.
FAQ
-
Was bedeutet es, wenn etwas „deprecated“ (veraltet) ist
-
Ein Skript, eine Datei oder ein anderer Teil des Codes ist veraltet, wenn seine Entwickler es durch modernen Code ersetzen oder vollständig entfernen.
-
Was passiert nach WordPress 5.6
-
Mit der Veröffentlichung von WordPress 5.6 wird auch die jQuery-Version aktualisiert. Das bedeutet, dass Plugins oder Themes, die vorher Deprecation-Warnungen erzeugt haben, jetzt stattdessen Fehler erzeugen.
Dieses Plugin erlaubt dir, temporär, zur vorherigen jQuery-Version zurückzukehren (er wird auch versuchen, dies automatisch für die Besucher der Website zu tun, wenn ein Fehler zum ersten Mal auftritt), um dir Zeit zu geben den Code zu reparieren oder zu ersetzen. -
Wie finde und benutze ich die Browser-Konsole
-
Auf WordPress.org gibt es einen Artikel über die Nutzung des Browser-Konsolen-Protokolls zur Diagnose von JavaScript-Fehlern (engl.).
-
Das Plugin protokolliert keine Deprecations und keine Änderungen der jQuery-Version
-
Wenn deine Website über Plugins zum Kombinieren von JavaScript-Dateien oder zum asynchronen Laden von Dateien verfügt, kann dieses Plugin beeinträchtigt werden und nicht wie vorgesehen funktionieren.
Wenn deine Website dieses Plugin benötigt, um zu funktionieren, deaktiviere bitte alle Plugins, die mit dem Laden von JavaScript-Dateien interagieren, wie z. B. die oben genannten. Sobald das zugrunde liegende Problem behoben ist, kannst du dieses Plugin entfernen und die anderen Tools wieder aktivieren.
-
Woher weiß ich, ob ich dieses Plugin benötige oder nicht
-
Wenn etwas auf deiner Website nicht richtig funktioniert, nachdem du WordPress aktualisiert hast, dann kannst du einfach versuchen, dieses Plugin zu installieren und zu aktivieren. Wenn das hilft, dann lass dieses Plugin aktiviert und folge den Anweisungen im Plugin. Das Plugin sagt dir, wenn du es nicht mehr benötigst.
-
Es gibt eine Menge Warnungen über veralteten Code bei der Verwendung von jQuery Version 3
-
Da jQuery-Version 3 sehr neu in WordPress ist, ist dies zu erwarten.
Deprecation-Hinweise zeigen, dass das Migrationstool funktioniert und sicherstellt, dass diese Funktionen weiterhin funktionieren, bis der entsprechende Code aktualisiert wird.
Rezensionen
Mitwirkende & Entwickler
„Enable jQuery Migrate Helper“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:
Mitwirkende„Enable jQuery Migrate Helper“ wurde in 16 Sprachen übersetzt. Danke an die Übersetzerinnen und Übersetzer für ihre Mitwirkung.
Übersetze „Enable jQuery Migrate Helper“ in deine Sprache.
Interessiert an der Entwicklung?
Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.
Änderungsprotokoll
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 ofconst
andlet
, 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
- Einstellungen-Seite hinzugefügt
- Added option for downgrading to legacy jQuery
- Automatische Downgrades hinzugefügt
- Added option to log deprecations in modern jQuery
- E-Mail-Benachrichtigungen hinzugefügt
- 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
- Option hinzugefügt, um die Hinweise auf veralteten Code im Backend auszublenden
- Protokollierung von Hinweisen auf veraltetem Code im Frontend ergänzt
- Eintrag in der Adminleiste ergänzt, der auf das Auftreten von veraltetem Code hinweist
- Auflistung der protokollierten Hinweise auf alten Code hinzugefügt
- Dashboard-Hinweis ergänzt, der die Benutzer zum Löschen des Plugins ermuntert, wenn für eine gewisse Zeit (1 Woche) keine Hinweise auf veralteten Code protokolliert wurden.
- Das Zeitintervall für die Anzeige des Hinweises auf dem Dashboard wurde von 2 Wochen auf 1 Woche geändert, während WordPress 5.6 sich nähert.
v 1.0.1
- Legt fest, dass einer der Administrations-Hinweise nicht unzulässig ist.
v 1.0.0
- Erstveröffentlichung.