get_template_directory_uri()

Définition : get_template_directory_uri() retourne l’URL du répertoire du thème parent WordPress, ou du thème actif en l’absence d’enfant. Elle sert à référencer des ressources publiques distribuées par le parent.

Terminologie

Nom technique : get_template_directory_uri()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Cette fonction évite de dépendre d’une adresse fixe de serveur et clarifie l’origine d’un fichier CSS, JavaScript ou image lorsqu’un thème enfant est actif.

Fonctionnement détaillé

WordPress construit une URL vers le répertoire du template actif. La valeur ne contient pas de slash terminal ; une ressource peut être ciblée en ajoutant un chemin relatif connu.

Quand l’utiliser : contexte et choix techniques

L’utiliser pour charger explicitement un asset conservé dans le parent. Préférer get_theme_file_uri() si le thème enfant doit pouvoir le remplacer avec son propre fichier.

Situation professionnelle réaliste

Un thème enfant conserve l’icône d’interface SVG du thème parent alors qu’il personnalise certaines feuilles CSS.

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 () {
    // Ressource fournie par le thème parent.
    wp_enqueue_style(
        'atoolpha-parent-base',
        get_template_directory_uri() . '/assets/css/base.css',
        array(), '1.0.0'
    );
} );

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

L’action wp_enqueue_scripts prépare le chargement frontal. L’URL pointe vers le dossier du parent ; le handle stable identifie la feuille et sa version permet de gérer le cache navigateur.

Résultat observable

La feuille base.css du parent est ajoutée à la file de chargement si ce fichier existe. WordPress ne vérifie pas automatiquement le contenu ni la disponibilité réseau du fichier.

Exercice de vérification pratique

Dans un thème enfant de développement, regarder l’URL de base.css dans la console réseau puis comparer avec l’URL que produirait get_stylesheet_directory_uri().

Pièges, limites et sécurité

Ne pas utiliser cette fonction pour inclure un fichier PHP sur le disque. Si l’asset doit être surchargeable, adapter le choix de l’URI ou utiliser la fonction prévue pour les fichiers du thème.

Différences avec les notions voisines

get_template_directory_uri() cible les ressources du parent ; get_stylesheet_directory_uri() cible celles du thème actif.

Diagnostic avancé et cas de maintenance

Cas avancé : une feuille parent et une feuille enfant possèdent le même nom. En utilisant explicitement l’URI parent, l’application ne sélectionnera pas par magie la copie enfant. Identifier le comportement de surcharge réellement voulu et enregistrer des handles séparés si les deux feuilles doivent cohabiter.