wp_register_script()

Définition : wp_register_script() déclare un fichier JavaScript et ses dépendances auprès de WordPress sans l’ajouter automatiquement à la page. Un autre composant peut ensuite charger ce script par son handle.

Terminologie

Nom technique : wp_register_script()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle encourage la réutilisation d’un même module dans différentes pages et évite de définir plusieurs fois son URL, sa version ou ses dépendances.

Fonctionnement détaillé

WordPress conserve l’identifiant du script et ses informations de chargement. L’exécution ne devient effective qu’une fois le handle placé dans la file, avec des arguments compatibles.

Quand l’utiliser : contexte et choix techniques

L’utiliser quand un module est facultatif et partagé entre plusieurs contextes. Le chargement systématique via wp_enqueue_script() reste approprié pour un fichier nécessaire partout.

Situation professionnelle réaliste

Un thème déclare un module de tableaux interactifs uniquement utilisé par certaines pages de ressources, plutôt que de l’imposer à la page d’accueil.

Exemple pratique — PHP commenté

Exemple pédagogique : adapter le nom du thème, les fichiers et les conditions à un environnement de développement. Il ne constitue pas une preuve d’exécution sur ATOOLPHA.

<?php
add_action( 'wp_enqueue_scripts', function () {
    wp_register_script(
        'atoolpha-tableaux-js',
        get_theme_file_uri( 'assets/js/tableaux.js' ),
        array(), '1.0.0', array( 'in_footer' => true )
    );
    if ( is_page( 'comparatif' ) ) {
        wp_enqueue_script( 'atoolpha-tableaux-js' );
    }
} );

Décryptage de l’exemple, étape par étape

Le module est enregistré avec une URL et une version. is_page() reconnaît le contexte visé ; le second appel demande son chargement. WordPress veille à ne pas multiplier les sorties du même handle.

Résultat observable

Le navigateur ne demande tableaux.js que sur la page correspondante, à condition que celle-ci existe et que le fichier soit distribué par le thème.

Exercice de vérification pratique

Dans une installation locale, comparer le réseau de la page comparatif et celui d’une autre page. Vérifier également que le code ne dépend pas d’un DOM absent.

Pièges, limites et sécurité

Le code JavaScript doit être compatible avec les politiques de sécurité et les dépendances déclarées. Enregistrer une ressource ne valide ni son contenu ni son accessibilité.

Différences avec les notions voisines

wp_register_script() déclare une ressource sans la charger ; wp_enqueue_script() programme le chargement effectif pour le navigateur.

Diagnostic avancé et cas de maintenance

Cas avancé : un tableau interactif n’est plus disponible sur une page renommée. La condition is_page() peut cibler un ancien slug alors que le script reste enregistré. Tester le contexte de page séparément, puis vérifier l’enqueue effectif et le chargement du fichier avant de rechercher une erreur dans son JavaScript.