wp_head

Définition : wp_head est une action WordPress déclenchée dans l’en-tête HTML des pages publiques lorsque le thème appelle la fonction correspondante. Elle sert notamment à insérer des métadonnées et des ressources nécessaires au rendu du site.

Terminologie

Terme : wp_head

Autres appellations : Hook en-tête, HTML Head Hook

À quoi cela sert

La fonction wp_head() est normalement appelée avant la fermeture de la balise head du document. Le Core et les extensions y attachent des traitements pour les feuilles de style, les scripts, les liens de flux, les métadonnées ou d’autres éléments propres à la page.

Dans quel contexte l’utiliser

L’utiliser seulement lorsqu’un contenu destiné à l’en-tête doit réellement être produit à cette étape. Préférer wp_enqueue_scripts pour les fichiers CSS ou JavaScript, afin de préserver la gestion native des dépendances et de l’ordre.

Exemple concret

Un thème compatible appelle wp_head() dans son template HTML pour laisser WordPress et les plugins injecter les métadonnées nécessaires.

Exemple de code commenté

<?php
// Extrait conceptuel d’un thème classique : header.php.
// Le HTML environnant est fourni par le thème.
wp_head(); // Exécute les callbacks liés au head.
// Puis le thème ferme sa balise </head>.

Explication de l’exemple

Le code illustre la présence du point d’extension dans un fichier de thème classique. L’élément est appelé avant la fermeture de head ; les callbacks enregistrés sur wp_head s’exécutent à cet emplacement.

Précautions et limites

Un thème qui omet wp_head() risque de casser le chargement de ressources et le fonctionnement d’extensions. Pour les thèmes blocs, ne pas transposer mécaniquement la structure d’un thème classique.