add_theme_support()

Définition : add_theme_support() déclare la prise en charge d’une fonctionnalité WordPress par le thème actif. Elle informe le Core que le thème sait gérer, par exemple, les miniatures, le titre du document ou certaines options.

Terminologie

Nom technique : add_theme_support()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle active des intégrations entre le thème, le Core et les interfaces éditoriales : le thème ne doit pas réimplémenter seul chaque fonctionnalité native.

Fonctionnement détaillé

La fonction enregistre des indicateurs de support associés à un nom de fonctionnalité et, selon le cas, à des paramètres. Elle doit généralement être appelée pendant after_setup_theme pour que l’information soit disponible au bon moment.

Quand l’utiliser : contexte et choix techniques

L’utiliser pour déclarer une capacité effectivement prise en charge par les templates. Un simple appel ne garantit pas que le thème possède les fichiers ou le balisage nécessaires pour afficher cette fonction.

Situation professionnelle réaliste

Un thème classique souhaite afficher des images mises en avant et déléguer à WordPress la gestion de la balise title.

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( 'after_setup_theme', function () {
    // Laisse WordPress contrôler le titre de la page.
    add_theme_support( 'title-tag' );
    // Autorise l’usage des miniatures d’articles.
    add_theme_support( 'post-thumbnails' );
    // Déclare les fonctionnalités HTML5 prises en charge.
    add_theme_support( 'html5', array( 'search-form', 'comment-form' ) );
} );

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

Après initialisation du thème, chaque support est ajouté au registre interne. HTML5 reçoit une liste de contextes déclarés ; post-thumbnails ne crée pas à lui seul une image dans les templates.

Résultat observable

Les interfaces et fonctions natives peuvent s’adapter aux supports annoncés. L’image mise en avant ne s’affiche sur le site public que si le thème la rend effectivement.

Exercice de vérification pratique

Activer le thème de démonstration et vérifier l’interface des miniatures. Ajouter temporairement un appel current_theme_supports() pour confirmer la déclaration.

Pièges, limites et sécurité

Certaines déclarations sont inutiles ou incompatibles avec des modes de thème spécifiques. Vérifier les exigences de chaque support dans la documentation officielle.

Différences avec les notions voisines

add_theme_support() déclare un support ; current_theme_supports() vérifie sa présence. Aucun des deux ne crée une fonctionnalité métier persistante.

Diagnostic avancé et cas de maintenance

Cas avancé : l’administration propose l’image mise en avant, mais la page publique ne montre rien. Le support a probablement été déclaré correctement ; il reste à vérifier l’existence de l’image et l’appel de rendu dans le template. Le support constitue un contrat de capacité, pas un affichage automatique.