wp_body_open()

Définition : wp_body_open() déclenche une action WordPress immédiatement après l’ouverture de la balise body lorsqu’un thème l’appelle. Elle fournit aux extensions un point d’intégration au début du document visible.

Comprendre et utiliser

À quoi sert ce terme ?

Elle permet d’ajouter des composants à un emplacement prévisible, par exemple un lien d’évitement ou un élément nécessaire à l’accessibilité, sans modifier directement le modèle d’un thème tiers.

Fonctionnement technique

Dans un thème classique, la fonction doit être placée juste après <body>. Elle déclenche le hook wp_body_open, auquel les extensions peuvent attacher leurs callbacks PHP.

Dans quels contextes l’utiliser ?

L’utiliser dans un thème que vous développez ou auditer sa présence avant de dépendre de ce hook. Certains anciens thèmes peuvent ne pas l’appeler.

Cas concret : ATOOLPHA

Un thème ATOOLPHA souhaite proposer un lien « Aller au contenu » dès le début de chaque page afin d’améliorer la navigation au clavier.

Exemple de code commenté

Extrait PHP destiné à un plugin ou à un template WordPress, dans le contexte indiqué ; pas au contenu HTML de l’article.

<?php
// Dans header.php, immédiatement après <body>.
wp_body_open();

// Dans le plugin, en dehors du modèle :
add_action( 'wp_body_open', function () {
    echo '<a class="skip-link" href="#contenu">Aller au contenu</a>';
} );

Décryptage de l’exemple

La fonction appelle le hook, tandis que l’extension y connecte son rendu. Le fragment n’est pas un modèle HTML complet : le thème doit également prévoir une cible unique avec id="contenu".

Résultat attendu

Un lien d’évitement apparaît après l’ouverture du body si le thème déclenche bien la fonction et si le plugin est actif.

Exercice pratique et vérification

Insérer le hook dans un thème de test, brancher un lien d’évitement, puis vérifier sa position, son focus et son fonctionnement dans le navigateur.

Précautions et limites

Vérifier l’existence réelle de la cible et son comportement au clavier ; ne pas injecter des composants arbitraires avant les scripts nécessaires à l’accessibilité.

À ne pas confondre

wp_body_open() est une fonction appelée dans le thème ; wp_body_open (sans parenthèses) désigne le hook auquel on peut rattacher une action.

Diagnostic avancé

Si le callback ne s’exécute jamais, rechercher d’abord l’appel wp_body_open() dans le thème actif avant de changer la priorité de l’action.

Choix d’architecture et déploiement

La présence de ce hook est une caractéristique de compatibilité du thème classique. Dans un audit, vérifier aussi le lien d’évitement, les repères de navigation et la hiérarchie du contenu pour qu’un ajout accessible ait réellement son effet attendu.