current_theme_supports()

Définition : current_theme_supports() vérifie si le thème WordPress actif a déclaré la prise en charge d’une fonctionnalité déterminée. Elle permet d’adapter des comportements selon les capacités effectivement annoncées.

Terminologie

Nom technique : current_theme_supports()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle aide un thème ou une extension à proposer un affichage de repli plutôt que de supposer qu’un support est toujours disponible sur tous les sites.

Fonctionnement détaillé

WordPress consulte le registre des supports ajoutés notamment par add_theme_support(). La fonction renvoie un booléen pour les vérifications habituelles, avec des possibilités supplémentaires pour certains supports particuliers.

Quand l’utiliser : contexte et choix techniques

L’utiliser dans du code qui doit rester compatible avec plusieurs thèmes, en particulier avant de dépendre d’une fonctionnalité déclarative comme les miniatures ou la gestion automatique du titre.

Situation professionnelle réaliste

Une extension de présentation affiche une image mise en avant uniquement si le thème la prend en charge.

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
// Dans un template ou un callback de rendu de contenu.
if ( current_theme_supports( 'post-thumbnails' ) ) {
    if ( has_post_thumbnail() ) {
        the_post_thumbnail( 'medium' );
    }
} else {
    // Présenter le contenu sans image mise en avant.
    echo '<p class="sans-image">Illustration non prévue.</p>';
}

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

Le premier test confirme la capacité du thème, le second vérifie qu’une image a effectivement été attribuée au contenu courant. Le code distingue donc deux situations qui ne sont pas équivalentes.

Résultat observable

L’image s’affiche lorsque les deux conditions sont remplies ; sinon, le thème fournit une présentation de repli pour l’absence de support.

Exercice de vérification pratique

Exécuter le même template avec deux thèmes de test, l’un déclarant post-thumbnails et l’autre non. Comparer les différences sans modifier les articles.

Pièges, limites et sécurité

Une déclaration de support n’implique pas que chaque contenu possède une image. La fonction ne doit pas servir à vérifier des permissions utilisateur.

Différences avec les notions voisines

current_theme_supports() vérifie une capacité du thème, tandis que current_user_can() vérifie les permissions de l’utilisateur courant.

Diagnostic avancé et cas de maintenance

Cas avancé : une extension doit afficher une galerie uniquement sur les thèmes capables de la prendre en charge. Tester d’abord la capacité déclarée ; prévoir ensuite un repli lisible, plutôt que masquer silencieusement le contenu. Une capacité technique ne renseigne pas les droits de l’utilisateur.