Klapt het menu niet meer uit of werkt de slideshow op je WordPress website ineens niet meer? Dat wordt waarschijnlijk veroorzaakt door de laatste update van WordPress.
WordPress 5.5 update
Op 11 augustus 2020 kwam WordPress 5.5 uit en al snel daarna kregen wij meldingen van klanten met problemen met hun websites. De meest voorkomende problemen die gemeld werden zijn:
- Menu klapt niet meer uit
- Slideshow doet het niet
- Bladeren naar een volgende pagina lukt niet
- Foto’s lukt niet (deze melding betreft de back-end of het beheerdersdeel van de website)
- Buttons werken niet meer (in de back-end of in de front-end)
Bug in WordPress 5.5?
Even dachten we dat er misschien een bug zat in WordPress 5.5, maar al snel zagen we een overeenkomst in de meldingen. Wat viel ons op?
- De website heeft een thema dat al lange tijd niet geüpdatet was (de laatste update is vaak langer dan een jaar geleden)
- Er is een plugin geïnstalleerd waar al langere tijd geen update meer voor is geïnstalleerd (de laatste update is meestal meer dan een jaar geleden)
- Beide, dus een verouderd thema en één of meer verouderde plugins op de website
De oorzaak van het niet meer goed werken van WordPress
Heel wat WordPress websites ervaren problemen sinds de update naar WordPress 5.5. De oorzaak: jQuery Migrate.
De ondersteuning van WordPress 5.5 voor jQuery Migrate is gestopt en heeft mogelijk ten minste 10.000 kapotte sites veroorzaakt.
Als het thema van je website gebruik maakt van jQuery 1.9 of ouder, heb je een probleem met je website na de update naar WordPress 5.5. Het thema is in zo’n geval meestal ook al behoorlijk oud en lange tijd niet geüpdatet.
Ook heb je problemen als er een verouderde plugin actief is op je website.
Wat is jQuery Migrate?
jQuery Migrate is een Javascript bibliotheek die ervoor zorgt dat versies die ouder zijn dan jQuery 1.9 gewoon werken. Het fungeert als een brug voor verouderde code zodat die oude code kan functioneren binnen WordPress. Dat uitklapmenu op je website is wellicht gemaakt met een oude versie van jQuery. Als dan jQuery Migrate niet aanwezig is in je website, werkt het menu niet. jQuery Migrate zorgt voor de brug van oud naar nieuw.
Wat moet je doen?
De oplossing voor het probleem is eenvoudig: update het WordPress thema naar de nieuwste versie of update de verouderde plugins.
WordPress thema updaten
Door het updaten van het thema maakt het thema gebruik van de nieuwste versie van jQuery en dit zal het probleem oplossen. Voor betaalde thema’s moet je mogelijk de licentie vernieuwen voordat je het kunt updaten.
Soms is het niet mogelijk om het thema te updaten. De ontwikkelaar brengt bijvoorbeeld al lange tijd geen updates meer uit voor het thema. Of het huidige thema van je website loopt inmiddels zoveel versies achter met de laatste versie van het thema, dat het haast een onmogelijke opgave is om probleemloos te upgraden. En soms zijn er aanpassingen gedaan in het thema die overschreven worden bij een update. Er is dan verzuimd een child theme te maken.
Plugins updaten
In onze hosting worden WordPress plugins automatisch up-to-date gehouden. Daardoor zouden er geen plugins in je WordPress installatie aanwezig moeten zijn die een update nodig hebben. Betaalde plugins worden echter niet altijd ook automatisch geüpdatet. Er dient dan een geldige licentie aanwezig te zijn voor de plugin. Heeft je website zo’n betaalde plugin die al langere tijd niet is geüpdatet en is de licentie verlopen, verleng dan de licentie en update de plugin om je website weer goed te laten draaien.
Net als bij een thema, is het soms niet mogelijk om een plugin te updaten. Wanneer de ontwikkelaar al langere tijd geen updates uitbrengt voor de plugin, valt er weinig te updaten voor jou en kun je het probleem met je website hiermee niet oplossen. Het beste kun je dan zoeken naar een plugin die hetzelfde doet als de oude plugin en die installeren. Vergeet niet de oude plugin te verwijderen. Verouderde plugins vormen een veiligheidsrisico voor je website. Het grootste deel van de gehackte WordPress websites wordt gehackt door een verouderde WordPress installatie of door een verouderde plugin.
Een noodoplossing: Enable jQuery Migrate Helper
Het thema updaten kan niet of er is geen alternatieve plugin te vinden?
WordPress heeft een plug-in uitgebracht die de jQuery Migrate JavaScript bibliotheek herstelt, waardoor thema’s of plugins die gebruik maken van jQuery 1.9 of ouder, daar weer gebruik van kunnen maken. Het is een lapmiddel, want feit is dat je thema of plugin verouderd is en veiligheidshalve een update nodig heeft, maar soms is het niet anders. Een niet werkende website is uiteraard ook geen optie.
De naam van de plugin is Enable jQuery Migrate Helper. De plugin is binnen een paar dagen na het uitkomen van WordPress 5.5 al meer dan 10.000 keer gedownload. Dat geeft al aan dat er veel websites door dit probleem zijn getroffen en er zullen er waarschijnlijk meer zijn die op zoek zijn naar deze oplossing.
Enable jQuery Migrate Helper installeren
De plugin Enable jQuery Migrate Helper installeer je net zo gemakkelijk als iedere andere plugin.
- Klik in het beheer van je WordPress website in het menu aan de linkerkant op Plugins > Nieuwe plugin.
- Typ in het zoekvenster Enable jQuery Migrate Helper.
- Klik bij de plugin Enable jQuery Migrate Helper op de knop Nu installeren.
- Klik op de knop Activeren. Na activatie laat de plugin zien welke verouderde jQuery scripts worden aangeroepen op de huidige beheerpagina. Deze meldingen zijn niet zichtbaar op de front-end van je website. Je website zou nu weer goed moeten werken.
