Comment réparer l'erreur WordPress « jQuery n'est pas défini » (6 façons)

Si vous voyez le Erreur « jQuery n'est pas défini » dans votre zone d'administration WordPress (ou ailleurs), ne vous inquiétez pas, vous n'êtes pas seul. Il s’agit d’un problème courant rencontré par de nombreux utilisateurs de WordPress. Cela dit, il peut être frustrant lorsque votre site ne fonctionne pas comme prévu.

Nous travaillons avec WordPress depuis plus d'une décennie et, pendant cette période, nous avons appris à dépanner et à résoudre certaines des erreurs WordPress les plus courantes. Cela inclut l'erreur « jQuery n'est pas défini ».

Dans ce guide, nous expliquerons pourquoi cette erreur se produit et, plus important encore, comment la corriger. Nous vous expliquerons tout en termes simples, ainsi même si vous n'êtes pas un développeur, vous pourrez suivre et résoudre le problème rapidement.

Quelles sont les causes de l'erreur « JQuery n'est pas défini » ?

jQuery est une bibliothèque JavaScript largement utilisée dans WordPress qui permet d'exécuter de nombreuses fonctionnalités interactives. Cependant, il arrive parfois qu’il ne se charge pas correctement, ce qui pourrait affecter la fonctionnalité de votre site Web.

L'erreur apparaît dans les outils de développement sous l'onglet Console, de sorte que de nombreux utilisateurs peuvent ne pas la remarquer jusqu'à ce que quelque chose se casse sur leur site.

Si vous voyez l'erreur « jQuery n'est pas défini », cela signifie que WordPress a du mal à le charger correctement. Au fil des années, nous avons aidé d'innombrables utilisateurs à résoudre ce problème, et nous avons appris qu'il provient généralement de quelques causes courantes :

1. Thèmes ou plugins obsolètes: De nombreux utilisateurs rencontrent cette erreur lorsque leurs thèmes ou plugins ne sont pas mis à jour pour correspondre à la dernière version de WordPress. Nous avons souvent vu cela se produire après des mises à jour majeures de WordPress.
2. Chargement incorrect du script: jQuery doit être chargé avant les autres fichiers JavaScript. Si ce n'est pas le cas, les scripts qui dépendent de jQuery seront interrompus. Cela se produit souvent si les thèmes ou les plugins ne sont pas codés correctement pour mettre les scripts en file d'attente.
3. Conflits JavaScript: D'autres scripts exécutés sur votre site peuvent entrer en conflit avec jQuery, surtout s'ils ne sont pas correctement chargés. Ce conflit peut interrompre jQuery, provoquant l'erreur.
4. Échecs du CDN: Certains sites s'appuient sur jQuery hébergé sur un Content Delivery Network (CDN). Si le CDN est indisponible ou bloqué, le site ne pourra pas charger jQuery, ce qui entraînera l'erreur.​

Tous ces problèmes peuvent empêcher le bon fonctionnement de jQuery. Mais ne vous inquiétez pas, grâce à notre expérience, nous pouvons vous guider vers les solutions pour résoudre le problème.

Comment corriger l'erreur « jQuery n'est pas défini »

Il existe plusieurs façons de corriger cette erreur lorsque vous la rencontrez. Vous trouverez ci-dessous les méthodes les plus efficaces que nous avons utilisées pour résoudre ce problème.

Nous vous recommandons d'essayer ces stratégies dans l'ordre, mais vous pouvez utiliser les liens ci-dessous si vous souhaitez commencer par une stratégie en particulier :

Nous passerons en revue chacune de ces méthodes et vous fournirons ensuite des ressources supplémentaires pour résoudre les erreurs WordPress. Allons-y !

1. Mettre à jour WordPress, les thèmes et les plugins

Les logiciels obsolètes sont l'une des causes les plus courantes de l'erreur « jQuery n'est pas défini ». Les thèmes ou plugins obsolètes peuvent ne pas être compatibles avec la dernière version de WordPress, ce qui peut entraîner des conflits de script. Pour résoudre ce problème :

Tout d’abord, assurez-vous que votre noyau WordPress est mis à jour. Accédez à Tableau de bord » Mises à jour et cliquez sur « Mettre à jour vers la version XXX » si une mise à jour est disponible.

Consultez notre guide complet sur la mise à jour en toute sécurité de WordPress vers une nouvelle version pour plus de détails.

Les mises à jour de votre plugin WordPress seront répertoriées sous la mise à jour principale.

Vous pouvez tous les sélectionner et cliquer sur « Mettre à jour les plugins ».

Enfin, vous verrez des mises à jour pour vos thèmes WordPress.

Sélectionnez-les simplement tous et cliquez sur « Mettre à jour les thèmes ».

Si vous êtes préoccupé par les modifications que vous avez apportées à votre thème, suivez notre guide pour savoir comment mettre à jour votre thème WordPress sans perdre les personnalisations.

2. Vérifiez si jQuery est chargé correctement

Avant d'explorer des solutions plus avancées, il est important de vérifier si jQuery est réellement chargé sur votre site. Cette étape vous aide à confirmer si jQuery est disponible et fonctionne comme il se doit.

Faites simplement un clic droit n'importe où sur votre site WordPress et sélectionnez « Afficher la source de la page ».

Cela vous montrera le HTML et le JavaScript bruts de votre page.

Ensuite, appuyez sur Ctrl + F (ou Cmd + F sur Mac) pour afficher la barre de recherche et tapez « jquery.min.js ».

Si jQuery est chargé correctement, vous devriez voir une référence dans le code.

Une autre façon de rechercher jQuery consiste à utiliser l'outil d'inspection de votre navigateur. Allez simplement dans l'onglet « Réseau » et rechargez la page.

Filtrez l'activité du réseau en tapant « jquery » dans la barre de recherche. Si jQuery est chargé, vous le verrez répertorié ici.

Si vous ne voyez pas jQuery chargé dans l'une ou l'autre méthode, le problème peut être dû à la façon dont il est mis en file d'attente dans WordPress. Dans les étapes suivantes, nous vous guiderons pour résoudre ce problème.

3. Ajouter une solution de secours jQuery

Parfois, un script sur votre site peut charger jQuery à l'aide d'un CDN qui rencontre des problèmes de connectivité. Dans ce cas, le chargement de jQuery échouerait et provoquerait l'erreur.

Pour résoudre le problème, vous pouvez ajouter une solution de secours jQuery à votre site WordPress. Cela garantit que jQuery est toujours chargé.

Vous devez l'ajouter à la section d'en-tête de votre site pour vous assurer qu'il se charge en premier. Cependant, nous ne recommandons pas de modifier directement les fichiers de thème. Nous avons vu des gens perdre leurs modifications lors de la mise à jour du thème et du code qu'ils ont ajouté.

La meilleure façon d’ajouter du code personnalisé dans WordPress est d’utiliser le Code WP plugin. Il s'agit d'un gestionnaire d'extraits de code qui vous permet d'ajouter du code personnalisé en toute sécurité sans endommager votre site.

Tout d’abord, installez et activez le Code WP plugin. Pour plus de détails, consultez notre tutoriel sur l'installation d'un plugin WordPress.

Une fois activé, allez sur Extraits de code »+ Ajouter un extrait. Ensuite, cliquez sur le bouton « Utiliser l'extrait » sous « Ajouter votre code personnalisé (nouvel extrait). »

Dans l'éditeur de code, donnez à votre extrait un nom tel que « jQuery Fallback ».

Après cela, sélectionnez « Extrait HTML » pour le « Type de code ».

Ensuite, collez le code suivant dans la case « Aperçu du code » :

Ensuite, faites défiler jusqu'à la section « Insertion ».

Ici, vous pouvez indiquer à WPCode où charger ce code. Assurez-vous de sélectionner « En-tête large du site ».

Enfin, cliquez sur le bouton « Enregistrer l'extrait » en haut pour enregistrer votre code personnalisé.

Après cela, n'oubliez pas d'activer l'extrait en basculant le bouton sur « Actif ».

4. Correction de l'ordre de chargement des scripts (avancé)

Une autre raison courante de l'erreur « jQuery n'est pas défini » est que jQuery se charge après d'autres scripts qui en dépendent. La correction de l'ordre de chargement du script garantit que jQuery est toujours chargé en premier, évitant ainsi les conflits.

Si vous savez quel script s'appuie sur jQuery, vous pouvez mettre ce script correctement en file d'attente en ajoutant jQuery en tant que dépendance.

Si l'erreur « jQuery n'est pas défini » est provoquée par le chargement de jQuery après d'autres scripts qui en dépendent, vous pouvez corriger l'ordre de chargement du script à l'aide de WPCode.

Tout d’abord, installez et activez le Code WP plugin, ou optez pour la version gratuite appelée WPCode Lite.

Une fois activé, allez sur Extraits de code »+ Ajouter un extrait et cliquez sur le bouton « Utiliser l'extrait » sous « Ajouter votre code personnalisé (nouvel extrait). »

Dans l'éditeur de code, donnez à votre extrait un nom tel que « Fix Script Loading Order » et sélectionnez « Extrait PHP » comme type de code.

Ensuite, ajoutez le code suivant pour vous assurer que jQuery est mis en file d'attente en tant que dépendance pour tous les scripts personnalisés :

wp_enqueue_script( 'your-script-handle', get_template_directory_uri() . '/js/your-script.js', array( 'jquery' ), null, true );

N'oubliez pas de remplacer « votre-script-handle » par un nom significatif pour identifier le script. Et remplacez « /js/your-script.js » par le nom réel du fichier de script dans le dossier /js/ de votre thème.

Le array('jquery') Une partie du code garantit que jQuery est chargé en premier.

Une fois que vous avez ajouté le code, faites défiler jusqu'aux options « Insertion » et sélectionnez « En-tête large du site » pour vous assurer que le script est chargé dans la partie droite du code HTML de votre site.

Enfin, cliquez sur le bouton « Enregistrer l'extrait » en haut pour enregistrer votre code personnalisé.

Après cela, n'oubliez pas d'activer l'extrait en basculant le bouton sur « Actif ».

L'utilisation de WPCode pour mettre correctement les scripts en file d'attente garantit que jQuery est chargé dans le bon ordre. Si c'était la racine du problème, cela devrait résoudre l'erreur.

5. Modifiez wp-config.php pour résoudre les problèmes de chargement de jQuery

Si les autres méthodes n'ont pas fonctionné, éditez le wp-config.php Le fichier peut aider en contrôlant la façon dont WordPress gère le chargement des scripts.

Cette méthode est utile si des problèmes de concaténation de script ou de chemin de fichier provoquent l'erreur « jQuery n'est pas défini ».

Voici comment appliquer cette méthode :

Tout d'abord, accédez à votre wp-config.php déposer. Vous pouvez le faire en utilisant un client FTP comme FileZilla ou en accédant au gestionnaire de fichiers dans votre panneau de contrôle d'hébergement.

Le wp-config.php Le fichier se trouve dans le répertoire racine de votre installation WordPress (généralement dans le public_html dossier).

Une fois que vous avez localisé le fichier, ouvrez-le pour le modifier et ajoutez le code suivant juste avant la ligne indiquant /* That’s all, stop editing! Happy blogging. */:

/** Absolute path to the WordPress directory. */
if ( !defined('ABSPATH') )
define('ABSPATH', dirname(FILE) . '/');
define('CONCATENATE_SCRIPTS', false);

Voici ce que fait ce code :

• Le ABSPATH La définition garantit que WordPress connaît le chemin correct vers ses fichiers principaux, ce qui peut éviter les problèmes de chargement de jQuery.
• Le CONCATENATE_SCRIPTS La ligne désactive la concaténation des scripts. Cela oblige WordPress à charger chaque script séparément, évitant ainsi les conflits qui surviennent lors de la fusion des scripts.

Après avoir ajouté ce code, enregistrez vos modifications et rechargez votre site pour voir si l'erreur a été résolue.

La désactivation de la concaténation des scripts peut être une solution simple mais efficace aux problèmes de jQuery, en particulier lorsque les autres méthodes ne fonctionnent pas.

6. Obtenez une assistance Premium pour corriger l'erreur pour vous

Si aucune des méthodes ci-dessus ne fonctionne ou si vous préférez simplement qu’un expert examine votre problème, vous devriez alors envisager d’utiliser nos services d’assistance WordPress Premium.

Pour une somme modique unique, vous pouvez embaucher nos ingénieurs WordPress professionnels hautement qualifiés pour corriger l’erreur pour vous.

Lorsque vous choisissez nos services d'urgence, vous n'aurez pas à vous soucier de corriger vous-même l'erreur « jQuery n'est pas défini ».

De cette façon, votre site connaîtra un temps d'arrêt minimal et vous pourrez reprendre vos activités commerciales en ligne dès que possible.

De plus, nos services d'urgence ne vous engageront pas dans un contrat, ce qui peut donc être une excellente option si vous n'êtes pas intéressé par un plan de support de maintenance complet.

Cela dit, nous proposons des services de maintenance plus complets si vous souhaitez adopter une approche plus proactive et réduire le risque d'urgences sur votre site Web à l'avenir.

Ressources bonus : dépannage des erreurs WordPress

Si toutes les étapes ci-dessus ne vous aident pas ou si vous souhaitez en savoir plus, les ressources suivantes pourraient être de bons points de départ :

Nous espérons que cet article vous a aidé à corriger l'erreur « jQuery n'est pas défini » dans WordPress. Vous voudrez peut-être également consulter notre guide sur la mise à niveau de jQuery vers la dernière version de WordPress ou notre sélection des meilleurs didacticiels jQuery pour les débutants WordPress.

Si vous avez aimé cet article, alors abonnez-vous à notre Chaîne YouTube pour les didacticiels vidéo WordPress. Vous pouvez également nous retrouver sur Gazouillement et Facebook.