wp_enqueue_scripts

Définition : wp_enqueue_scripts est une action WordPress dédiée à l’enregistrement et au chargement des scripts et feuilles de style sur la partie publique du site. Elle permet de gérer les dépendances et d’éviter les inclusions manuelles dispersées.

Terminologie

Terme : wp_enqueue_scripts

Autres appellations : Chargement de scripts front-end, Scripts et styles publics

À quoi cela sert

Le hook est déclenché lorsque WordPress prépare les ressources du front-end. Les fonctions wp_enqueue_script() et wp_enqueue_style() déclarent des identifiants de ressources, leurs chemins, leurs dépendances et leurs versions. WordPress orchestre ensuite leur insertion dans la page.

Dans quel contexte l’utiliser

L’utiliser dans un plugin ou un thème pour charger uniquement les ressources nécessaires. Pour les écrans d’administration, utiliser admin_enqueue_scripts et éviter de charger les fichiers du back-office sur toutes les pages publiques.

Exemple concret

Une extension prévoit une feuille CSS dédiée à son interface publique, fournie dans son répertoire assets.

Exemple de code commenté

<?php
// Exemple dans le fichier principal d’un plugin.
add_action( 'wp_enqueue_scripts', function () {
    wp_enqueue_style(
        'atoolpha-front',
        plugins_url( 'assets/front.css', __FILE__ ),
        array(),
        '1.0.0'
    );
} );
// Prérequis : le fichier assets/front.css existe.

Explication de l’exemple

Le callback construit l’URL à partir du fichier du plugin et inscrit la feuille de style avec un identifiant stable. Le fichier assets/front.css doit réellement être présent dans l’extension pour que le navigateur puisse le charger.