get_stylesheet_directory()

Définition : get_stylesheet_directory() renvoie le chemin absolu du dossier du thème actif WordPress, c’est-à-dire celui du thème enfant lorsque celui-ci est activé, et non nécessairement celui du thème parent.

Terminologie

Nom technique : get_stylesheet_directory()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle sert à localiser des fichiers internes au thème actif, indépendamment du dossier racine du serveur. Cette distinction est particulièrement utile quand une personnalisation est livrée dans un thème enfant.

Fonctionnement détaillé

WordPress identifie le stylesheet actif et déduit son emplacement sur le système de fichiers. Le chemin retourné n’a pas de slash final et n’est pas une URL destinée au navigateur.

Quand l’utiliser : contexte et choix techniques

L’utiliser pour lire un fichier interne spécifique au thème enfant. Si un fichier doit être récupéré avec une logique de repli vers le parent, préférer get_theme_file_path().

Situation professionnelle réaliste

Un thème enfant stocke une configuration de présentation privée au sein de son répertoire inc, sans référencer un chemin fixe chez l’hébergeur.

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
// Exemple : chercher un fichier dans le thème réellement actif.
$file = get_stylesheet_directory() . '/inc/options.php';
if ( is_readable( $file ) ) {
    require_once $file;
}
// Avec un thème enfant actif, le dossier de l’enfant est utilisé.

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

La fonction donne le chemin local du thème activé. Le suffixe /inc/options.php désigne un fichier connu. is_readable() teste sa présence avant de le charger avec require_once.

Résultat observable

Le module du thème enfant est chargé s’il existe ; aucune copie implicite depuis le parent n’est recherchée par cette méthode.

Exercice de vérification pratique

Afficher temporairement le chemin en environnement local sans l’exposer aux visiteurs. Activer un thème enfant puis comparer avec get_template_directory() pour voir la différence.

Pièges, limites et sécurité

Ne pas afficher les chemins absolus dans les pages publiques. Ne pas utiliser cette fonction pour construire une URL CSS, et ne pas composer le suffixe à partir de paramètres non contrôlés.

Différences avec les notions voisines

get_stylesheet_directory() renvoie un chemin sur disque, alors que get_stylesheet_directory_uri() renvoie une URL publique du même dossier.

Diagnostic avancé et cas de maintenance

Cas avancé : une inclusion fonctionne avec un thème sans enfant, puis échoue après l’activation de l’enfant. Le chemin retourné a changé. S’il faut lire une ressource propre au parent, choisir get_template_directory() ; si l’on souhaite autoriser une surcharge, préférer une fonction avec repli explicite.