Table des matières:
Pourquoi l’erreur ‘jQuery is not defined’ apparaît-elle sur WordPress ?
L’erreur ‘jQuery is not defined’ est l’un des problèmes les plus fréquents rencontrés par les utilisateurs de WordPress. Elle survient généralement lorsque jQuery, une bibliothèque JavaScript essentielle, n’est pas chargée correctement ou est chargée après les scripts qui en dépendent. En 2026, avec l’évolution des thèmes et des plugins, cette erreur peut encore se manifester, mais les solutions sont bien documentées.
Causes principales de l’erreur
- Conflit de plugins : Un plugin charge une version obsolète de jQuery ou désactive le chargement de jQuery par WordPress.
- Thème mal codé : Un thème qui ne respecte pas les bonnes pratiques d’encastrement des scripts.
- Ordre de chargement incorrect : Les scripts dépendant de jQuery sont exécutés avant que jQuery ne soit disponible.
- CDN défaillant : Si jQuery est chargé depuis un CDN externe et que celui-ci est inaccessible.
- Cache ou minification : Des plugins de cache ou de minification peuvent altérer l’ordre des scripts.
Comment diagnostiquer l’erreur ‘jQuery is not defined’ sur WordPress ?
Avant de corriger l’erreur, il est crucial de l’identifier précisément. Utilisez la console de votre navigateur (F12) pour repérer le message d’erreur et la ligne de code concernée. Vérifiez également si le problème est lié à un thème ou un plugin spécifique en désactivant temporairement tous les plugins et en passant à un thème par défaut (comme Twenty Twenty-Four).
Étapes de diagnostic
- Ouvrez la console du navigateur (Ctrl+Shift+J ou Cmd+Option+J).
- Recherchez le message ‘jQuery is not defined’ et notez le fichier et la ligne.
- Désactivez tous les plugins et réactivez-les un par un pour trouver le responsable.
- Testez avec un thème par défaut pour exclure un problème de thème.
Solutions pour corriger l’erreur ‘jQuery is not defined’ en 2026
Voici les méthodes les plus efficaces pour résoudre cette erreur sur votre site WordPress.
1. Assurez-vous que jQuery est chargé correctement
WordPress inclut jQuery par défaut. Vérifiez que votre thème ou plugin utilise bien la fonction wp_enqueue_script() pour charger jQuery. Évitez de charger jQuery manuellement avec une balise <script> dans le header, car cela peut créer des doublons ou des conflits.
2. Corrigez l’ordre de chargement des scripts
Les scripts qui dépendent de jQuery doivent être chargés après jQuery. Utilisez la dépendance array('jquery') dans votre appel à wp_enqueue_script(). Par exemple :
wp_enqueue_script('mon-script', get_template_directory_uri() . '/js/mon-script.js', array('jquery'), '1.0', true);3. Vérifiez les conflits de plugins
Certains plugins, comme les optimiseurs de performance, peuvent désactiver jQuery pour réduire les requêtes. Désactivez ces plugins temporairement pour voir si l’erreur disparaît. Si c’est le cas, configurez le plugin pour qu’il ne touche pas à jQuery.
4. Utilisez une version compatible de jQuery
En 2026, la version de jQuery incluse dans WordPress est généralement la 3.x. Si un plugin ou thème nécessite une version plus ancienne, cela peut causer des erreurs. Mettez à jour vos plugins et thèmes, ou utilisez un plugin comme jQuery Updater pour gérer les versions.
5. Chargez jQuery depuis un CDN fiable
Si vous chargez jQuery depuis un CDN externe (Google, jQuery.com), assurez-vous que le CDN est accessible. Vous pouvez également charger jQuery localement en utilisant le fichier inclus dans WordPress.
6. Videz le cache et les fichiers minifiés
Les plugins de cache et de minification peuvent parfois altérer l’ordre des scripts. Videz le cache de votre site et désactivez temporairement la minification pour tester.
Prévenir l’erreur ‘jQuery is not defined’ à l’avenir
Pour éviter que cette erreur ne se reproduise, adoptez ces bonnes pratiques :
- Utilisez toujours les fonctions WordPress pour charger les scripts.
- Mettez régulièrement à jour vos thèmes et plugins.
- Testez les mises à jour sur un environnement de staging.
- Évitez les plugins obsolètes ou mal codés.
- Utilisez un thème compatible avec la dernière version de WordPress.
Conclusion
L’erreur ‘jQuery is not defined’ sur WordPress en 2026 peut sembler intimidante, mais avec une approche méthodique, elle est facile à résoudre. En suivant les étapes de diagnostic et les solutions proposées dans ce guide, vous pourrez restaurer rapidement le bon fonctionnement de votre site. N’oubliez pas de toujours tester les modifications sur un site de staging avant de les appliquer en production. Pour toute question, n’hésitez pas à consulter la documentation officielle de WordPress ou à faire appel à un développeur spécialisé.
Photo by Pardies, Ignace-Gaston, 1636-1673 on Wikimedia Commons
