Meta Box

Définition : Une Meta Box est un panneau ajouté à un écran de modification WordPress afin de présenter des informations ou des champs propres à un contenu. Son enregistrement relève de l’API correspondante.

Terminologie

Terme officiel : Meta Box

Autres appellations : Boîte de métadonnées, Metabox

À quoi cela sert

Elle regroupe des informations complémentaires directement à côté de l’édition d’un contenu : référence interne, état éditorial ou indication de suivi. Le lecteur comprend ainsi comment un plugin enrichit l’administration sans modifier les tables du Core.

Comment cela fonctionne

Le plugin enregistre un identifiant, un titre et un callback de rendu avec add_meta_box(). Le panneau est affiché dans l’écran d’édition approprié ; l’enregistrement des données nécessite une routine distincte avec droits, nonce, validation et gestion des révisions.

Dans quel contexte l’utiliser

Utiliser cette interface quand des données propres à un article ou à un type de contenu personnalisé doivent être saisies avec l’article. Pour une expérience native avancée de Gutenberg, envisager plutôt les API de l’éditeur.

Exemple concret

Un rédacteur associe à une fiche technique une référence de documentation interne qu’il retrouve ensuite dans l’interface de modification.

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
// Exemple de panneau de lecture dans l’éditeur classique / compatibilité.
add_action( 'add_meta_boxes', function () {
    add_meta_box( 'atoolpha_reference', 'Référence interne', function ( $post ) {
        $val = get_post_meta( $post->ID, '_atoolpha_reference', true );
        echo '<p>' . esc_html( (string) $val ) . '</p>';
    }, 'post', 'side' );
} );

Explication pas à pas de l’exemple

1. L’action add_meta_boxes déclenche la déclaration du panneau. 2. add_meta_box() associe son identifiant au type post. 3. Le callback récupère une valeur déjà enregistrée et l’affiche en échappant son contenu. 4. Aucune écriture n’a lieu.

Résultat attendu

Le panneau « Référence interne » apparaît dans les contextes d’édition qui prennent en charge cette boîte ; sa valeur est affichée si elle a déjà été enregistrée.

Mise en pratique guidée

Dans un environnement de test, ouvrir un article existant et repérer le panneau « Référence interne ». Modifier ensuite la métadonnée correspondante au moyen d’un traitement autorisé : le panneau doit afficher sa nouvelle valeur après rechargement. Ce test sépare volontairement l’affichage de l’enregistrement, ce qui permet d’identifier la responsabilité de chacun.

Précautions et limites

Une Meta Box n’offre pas automatiquement la sauvegarde. Ne pas afficher de valeur utilisateur sans échappement. Les interfaces modernes de Gutenberg peuvent offrir des intégrations plus adaptées.