get_template_directory()

Définition : get_template_directory() récupère le chemin absolu du répertoire du thème parent WordPress, ou du thème actif lorsqu’aucun enfant n’est utilisé. Ce résultat correspond à un emplacement sur le serveur.

Terminologie

Nom technique : get_template_directory()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle facilite les références à des fichiers distribués par le thème parent, par exemple un module dont l’emplacement n’est pas prévu pour être surchargé par l’enfant.

Fonctionnement détaillé

WordPress détermine le template actif et le répertoire correspondant. Dans une installation avec thème enfant, le nom template désigne le parent, tandis que stylesheet désigne le thème activé.

Quand l’utiliser : contexte et choix techniques

L’utiliser uniquement quand l’accès explicite au dossier parent est recherché. Pour permettre une surcharge par thème enfant, utiliser plutôt get_theme_file_path() ou locate_template().

Situation professionnelle réaliste

Un thème enfant a besoin de consulter le fichier manifeste fourni exclusivement par le thème parent, sans chercher une copie dans l’enfant.

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
// Lecture d’un fichier connu du thème parent.
$parent_file = get_template_directory() . '/inc/manifest.php';
if ( is_readable( $parent_file ) ) {
    require_once $parent_file;
}
// À distinguer de get_stylesheet_directory().

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

La fonction obtient le chemin du template parent. Le suffixe fixe identifie une ressource interne connue. Le chargement s’effectue seulement si le fichier existe et peut être lu.

Résultat observable

Lorsque le thème enfant est actif, le fichier chargé provient du parent. En l’absence du fichier, l’exemple n’effectue aucune inclusion.

Exercice de vérification pratique

Activer un thème enfant dans une installation de test. Comparer les deux chemins retournés par get_template_directory() et get_stylesheet_directory() puis déplacer uniquement le fichier du parent.

Pièges, limites et sécurité

Le chemin absolu peut révéler la structure de l’hébergement : ne jamais l’exposer publiquement. Ne pas remplacer un mécanisme prévu de surcharge par un accès rigide au parent.

Différences avec les notions voisines

get_template_directory() cible le parent ; get_stylesheet_directory() cible le thème actuellement activé, qui peut être l’enfant.

Diagnostic avancé et cas de maintenance

Cas avancé : une personnalisation d’un fichier du parent n’est pas prise en compte parce que l’équipe attendait une surcharge par l’enfant. Cette fonction vise explicitement le parent. Séparer les fichiers que l’enfant peut remplacer des ressources volontairement fixes pour éviter les comportements surprenants.