get_stylesheet_directory_uri()

Définition : get_stylesheet_directory_uri() renvoie l’URL du répertoire du thème actif WordPress. Lorsqu’un thème enfant est activé, elle pointe sur les ressources propres à l’enfant plutôt que sur son parent.

Terminologie

Nom technique : get_stylesheet_directory_uri()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle est utile pour référencer des images, feuilles CSS et fichiers JavaScript distribués dans un thème, sans coder en dur le domaine ou l’emplacement de l’installation.

Fonctionnement détaillé

WordPress construit une adresse web correspondant au dossier stylesheet actif. Le résultat est une URI, sans slash terminal ; son format diffère du chemin de disque donné par get_stylesheet_directory().

Quand l’utiliser : contexte et choix techniques

L’utiliser pour les ressources statiques du thème enfant dont le nom est connu. Pour des fichiers pouvant être surchargés entre parent et enfant, get_theme_file_uri() offre une logique plus souple.

Situation professionnelle réaliste

Une image d’interface propre au thème enfant est insérée sur une page sans dépendre du nom de domaine courant.

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
// À utiliser dans un template PHP classique.
$image = get_stylesheet_directory_uri() . '/assets/img/logo-demo.svg';
echo '<img src="' . esc_url( $image ) . '"';
echo ' alt="Logo du site" width="120" height="40">';

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

L’URL du dossier actif est complétée par un chemin de ressource constant. esc_url() protège l’insertion dans l’attribut src. Les attributs dimensions et alt sont explicitement fournis.

Résultat observable

Le navigateur tente de charger le fichier SVG fourni par le thème actif. Si ce fichier n’existe pas, l’image ne s’affiche pas ; la fonction ne crée pas de fichier.

Exercice de vérification pratique

Inspecter le HTML et l’onglet Réseau du navigateur. Vérifier que l’URL pointe vers le bon thème enfant et que le serveur renvoie correctement l’image.

Pièges, limites et sécurité

Ne pas utiliser une URI comme chemin PHP pour require_once. Échapper toute URL affichée et renseigner les attributs alternatifs pertinents pour l’accessibilité.

Différences avec les notions voisines

get_stylesheet_directory_uri() produit une URL ; get_stylesheet_directory() produit un chemin local utilisable par PHP.

Diagnostic avancé et cas de maintenance

Cas avancé : un serveur déplace WordPress dans un autre chemin ou domaine. Les URL codées en dur cessent de fonctionner, tandis que les fonctions WordPress reconstruisent le chemin public du thème actif. Tester les ressources après migration et distinguer erreur d’URL, réponse 404 et politique de sécurité du navigateur.