add_meta_boxes

Définition : add_meta_boxes est une action WordPress déclenchée lors de la préparation des boîtes de métadonnées de l’éditeur. Elle permet aux extensions d’enregistrer leurs propres panneaux avec add_meta_box().

Terminologie

Terme officiel : add_meta_boxes

Autres appellations : Hook add_meta_boxes

À quoi cela sert

Le hook situe l’enregistrement d’une interface au moment attendu, plutôt que lors de chaque chargement générique d’une page ou d’une requête publique.

Comment cela fonctionne

WordPress transmet notamment le type de contenu et l’objet correspondant lors de l’action. Un callback peut tester ce contexte pour créer la boîte uniquement là où elle est utile.

Dans quel contexte l’utiliser

À utiliser lors de l’ajout d’une boîte de saisie à un post ou à un type personnalisé compatible, et non pour sauvegarder la valeur de ses champs.

Exemple concret

Le panneau « Contrôle qualité » doit apparaître pour les articles, mais pas pour les pages.

Exemple de code commenté

Extrait pédagogique PHP pour extension WordPress : adapter au contexte et tester sur un environnement de développement avant tout usage.

<?php
add_action( 'add_meta_boxes', function ( $post_type, $post ) {
    if ( 'post' !== $post_type ) {
        return;
    }
    add_meta_box( 'atoolpha_qualite', 'Contrôle qualité', function () {
        echo '<p>Vérifier la terminologie avant publication.</p>';
    }, 'post', 'side' );
}, 10, 2 );

Explication pas à pas de l’exemple

1. Le hook reçoit deux arguments grâce au paramètre accepted_args égal à 2. 2. Le type de contenu est comparé à post. 3. Le panneau est déclaré seulement dans ce contexte. 4. Aucun traitement public n’est ajouté.

Résultat attendu

La boîte « Contrôle qualité » est proposée lors de la modification d’articles et reste absente des autres types de contenus.

Mise en pratique guidée

Brancher un callback affichant un texte constant, puis tester successivement un article et une page. La condition sur le type post doit empêcher le panneau de se déclarer sur les pages. Observer que la fonction n’écrit aucune donnée : le hook concerne la composition de l’écran et non la persistance des champs.