wp_enqueue est une fonction de WordPress qui permet aux développeurs/développeuses de mettre en file d’attente les scripts (fichiers JavaScript) et les styles (fichiers CSS).
Cela signifie que les développeurs/développeuses peuvent indiquer à WordPress les scripts et les styles qu’ils souhaitent utiliser sur une page donnée, et WordPress les chargera automatiquement.
Cela permet de s’assurer que vos pages se chargent rapidement et efficacement, et cela peut également aider à prévenir les conflits entre les différents scripts et styles.
En mettant correctement les scripts en file d’attente, les développeurs/développeuses peuvent créer des extensions, des thèmes et des sites web efficaces, faciles à entretenir et compatibles.
Quand faut-il placer JavaScript et CSS en file d’attente dans WordPress ?
Vous pouvez utiliser le code JavaScript et CSS pour personnaliser votre site WordPress, et les développeurs/développeuses utilisent ces langages lors de la création d’extensions et de thèmes WordPress.
- JavaScript s’exécute sur le navigateur de l’utilisateur et compte pour ajouter des éléments interactifs à votre site, tels que des modules, des alertes, des boutons, des fenêtres surgissantes, etc.
- LeCSS (Cascading Style Sheets) est utilisé pour définir l’apparence visuelle de votre site, comme la taille et la couleur des polices, la couleur d’arrière-plan et la largeur de la page.
Si vous êtes propriétaire d’un site et que vous souhaitez ajouter du JavaScript et du CSS à des publications et des pages spécifiques, alors vous n’aurez pas besoin d’utiliser wp_enqueue. Nous vous recommandons plutôt d’utiliser l’extension d’extraits de code WPCode, car c’est le moyen le plus sûr d’ajouter du code à un site WordPress.
Vous pouvez en savoir plus dans nos guides sur la façon d’ajouter facilement du JavaScript et sur la façon d’ajouter facilement du CSS personnalisé à votre site WordPress.
Cependant, si vous êtes un développeur/développeuse ou que vous apprenez à créer des extensions et des thèmes WordPress, alors vous devrez correctement mettre en file d’attente les fichiers JavaScript et les feuilles de style CSS dans vos projets.
Comment fonctionne le système de mise en file d’attente de WordPress ?
Les nouvelles développeurs/développeuses peuvent commettre l’erreur d’appeler directement les scripts et les feuilles de style dans leurs extensions et leurs thèmes. Cela peut entraîner des conflits et nuire aux performances de WordPress.
Pour éviter ces problèmes, WordPress propose un système de mise en file d’attente. Les développeurs/développeuses disposent ainsi d’un moyen de charger les scripts et les feuilles de style afin que tout fonctionne correctement et sans conflit.
Voici comment fonctionne le système de mise en file d’attente :
- Tout d’abord, vous devez inscrire le script ou la feuille de style à l’aide de la fonction
wp_registerafin que WordPress sache qu’il existe et où le trouver. - Ensuite, vous mettez en file d’attente les scripts et les feuilles de style à l’aide de la fonction wp_enqueue, ce qui permet à WordPress de savoir que vous souhaitez les charger.
- Ensuite, une fois la page chargée, WordPress chargera tous les scripts en file d’attente dans le bon ordre afin de s’assurer que tout fonctionne correctement.
Vous pouvez en savoir plus dans notre guide sur la façon d’ajouter correctement du JavaScript et des styles dans WordPress.
Exemples de codes
Vous pouvez utiliser les fonctions wp_enqueue_script et wp_enqueue_style pour indiquer à WordPress quand charger un fichier, où le trouver et quelles sont ses dépendances.
Vous pouvez consulter des exemples de code utiles qui démontrent comment utiliser le système de mise en file d’attente de WordPress.
Voici un exemple de code que vous pouvez coller dans vos fichiers d’extension ou dans le fichierfunctions.php de votre thème pour charger correctement les scripts dans WordPress :
?php
function wpb_adding_scripts() {
wp_register_script('my_amazing_script', plugins_url('amazing_script.js', __FILE__), array('jquery'),'1.1', true);
wp_enqueue_script('my_amazing_script');
}
add_action( 'wp_enqueue_scripts', 'wpb_adding_scripts' );
?>
Et voici un exemple de mise en file d’attente de vos feuilles de style :
<?php
function wpb_adding_styles() {
wp_register_style('my_stylesheet', plugins_url('my-stylesheet.css', __FILE__));
wp_enqueue_style('my_stylesheet');
}
add_action( 'wp_enqueue_scripts', 'wpb_adding_styles' );
?>
Pour des explications complètes sur ces exemples de code, veuillez consulter notre guide sur la manière d’ajouter correctement du JavaScript et des styles dans WordPress.
Nous espérons que cet article vous a aidé à en savoir plus sur wp_enqueue dans WordPress. Vous pouvez également consulter notre liste de lectures complémentaires ci-dessous pour des articles liés à des astuces, des conseils et des idées utiles sur WordPress.
Si vous avez aimé cet article, veuillez alors vous abonner à notre chaîne YouTube pour obtenir des tutoriels vidéo sur WordPress. Vous pouvez également nous trouver sur Twitter et Facebook.
