get_header()

Définition : get_header() insère le modèle d’en-tête PHP d’un thème WordPress classique. Elle charge header.php ou une variante nommée, afin de mutualiser les éléments situés au début du document HTML.

Terminologie

Nom technique : get_header()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle évite de répéter le doctype, l’ouverture des éléments structurants, la navigation et les appels nécessaires au système de hooks WordPress dans chaque template.

Fonctionnement détaillé

WordPress cherche un fichier header.php ou header-nom.php, déclenche le hook approprié et inclut le template sélectionné. Le paramètre args permet de transmettre des valeurs au fragment depuis WordPress 5.5.

Quand l’utiliser : contexte et choix techniques

Appeler get_header() au début d’un template PHP classique comme page.php ou single.php. Pour un thème à blocs, l’intégration habituelle passe plutôt par une partie de modèle.

Situation professionnelle réaliste

Un site possède deux variantes d’en-tête, dont une version allégée réservée à certaines pages de documentation.

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 PHP : utiliser header-compact.php si nécessaire.
get_header( 'compact', array( 'zone' => 'documentation' ) );
// Suite du rendu de la page.
if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        the_title( '<h1>', '</h1>' );
        the_content();
    }
}
get_footer();

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

Le nom compact cible header-compact.php. Le tableau zone peut être lu dans ce fichier via $args. Le corps du template rend ensuite la publication courante, puis termine la page avec get_footer().

Résultat observable

Si le fichier ciblé existe, son en-tête est affiché. Le template en question doit produire un HTML cohérent et inclure wp_head() à l’emplacement recommandé.

Exercice de vérification pratique

Ajouter un header-compact.php dans une copie locale du thème, puis comparer l’affichage de deux templates. Vérifier la présence de wp_head() et l’ordre des éléments HTML dans la page source.

Pièges, limites et sécurité

Les fichiers spécialisés absents peuvent provoquer un comportement de repli selon la recherche des modèles. Ne pas déclarer plusieurs fois les balises structurantes du document.

Différences avec les notions voisines

get_header() charge un template PHP ; wp_head est un hook généralement invoqué dans la section head de l’en-tête.

Diagnostic avancé et cas de maintenance

Cas avancé : un script de suivi ou de plugin ne se charge pas sur certaines pages utilisant header-compact.php. Vérifier si cette variante appelle bien wp_head() et respecte la structure commune du document. Chaque en-tête spécialisé reste responsable des points d’extension fondamentaux.