after_setup_theme

Définition : after_setup_theme est une action WordPress lancée après le chargement du fichier de fonctions du thème. Elle permet de déclarer les capacités et paramètres du thème avant les étapes suivantes d’initialisation.

Terminologie

Terme : after_setup_theme

Autres appellations : Après configuration du thème, Theme Setup Hook

À quoi cela sert

Le hook s’exécute après le chargement du thème actif, notamment de functions.php, mais avant init. Il est fréquemment utilisé pour add_theme_support(), l’enregistrement de menus ou le chargement de traductions selon les recommandations applicables.

Dans quel contexte l’utiliser

L’utiliser dans un thème classique ou compatible pour signaler une fonctionnalité supportée, comme les miniatures mises en avant. Pour des comportements indépendants de l’apparence, préférer un plugin adapté.

Exemple concret

Un thème annonce à WordPress qu’il prend en charge les images mises en avant et laisse ensuite l’administration proposer le dispositif natif.

Exemple de code commenté

<?php
// Dans le fichier functions.php d’un thème.
add_action( 'after_setup_theme', function () {
    add_theme_support( 'post-thumbnails', array( 'post' ) );
} );

Explication de l’exemple

Le callback ne crée aucune image ; il déclare la prise en charge de post-thumbnails pour les publications. L’affichage de la miniature dépend ensuite du template et de la présence d’une image.

Précautions et limites

Le fichier functions.php doit appartenir au thème concerné. Déplacer cet exemple dans une extension peut modifier sa portée et ne remplace pas les conventions des thèmes blocs.