Méta-boîte WordPress qui ne s’affiche pas : causes et solutions

Cet article est une édition localisée de l'original japonais. Lire l'original en japonais

Introduction

Une méta-boîte ajoutée par une extension n'apparaît pas sur l'écran d'édition des articles, une méta-boîte autrefois visible a soudain disparu, ou les méta-boîtes de la colonne latérale ne s'affichent plus après le passage à l'éditeur de blocs. Les réglages de l'écran et la compatibilité avec l'éditeur de blocs interviennent dans la disparition d'une méta-boîte.

Symptômes et causes

Principales causes d'une méta-boîte qui ne s'affiche pas :

• Masquée dans les Options de l'écran : le réglage d'affichage propre à chaque utilisateur est sur « masqué »
• Incompatibilité avec l'éditeur de blocs : le réglage __block_editor_compatible_meta_box est nécessaire
• Problème de priorité du hook : le moment d'exécution du hook add_meta_boxes ne convient pas
• Type de contenu mal indiqué : le type de contenu du troisième argument est incorrect
• Conflit d'extensions : une autre extension supprime la méta-boîte

Procédure de résolution

Étape 1 : vérifier les Options de l’écran

La cause la plus fréquente est le masquage dans les Options de l'écran.

1. Cliquez sur « Options de l'écran » (Screen Options) en haut à droite de l'écran d'édition de l'article

2. Vérifiez que la case de la méta-boîte à afficher n'est pas décochée

3. Cochez-la et refermez le panneau : la méta-boîte s'affiche

Étape 2 : vérifier l’implémentation de add_meta_box

// functions.php — ajouter correctement une méta-boîte
add_action('add_meta_boxes', function() {
    add_meta_box(
        'my_meta_box_id',       // ID (chaîne unique)
        'Infos personnalisées',           // Titre
        'render_my_meta_box',   // Fonction de rappel
        ['post', 'page'],       // Types de contenu (tableau pour en indiquer plusieurs)
        'normal',               // Contexte : normal/side/advanced
        'high'                  // Priorité : high/core/default/low
    );
});

function render_my_meta_box($post) {
    wp_nonce_field('my_meta_nonce_action', 'my_meta_nonce');
    $value = get_post_meta($post->ID, '_my_field', true);
    echo '<input type="text" name="my_field" value="' . esc_attr($value) . '">';
}

Étape 3 : afficher la méta-boîte dans l’éditeur de blocs

Dans l'éditeur de blocs (Gutenberg), la prise en charge des méta-boîtes est limitée.

// Afficher la méta-boîte aussi dans l'éditeur de blocs
add_action('add_meta_boxes', function() {
    add_meta_box(
        'my_meta_box_id',
        'Infos personnalisées',
        'render_my_meta_box',
        'post',
        'normal',
        'high',
        // Déclarer explicitement la compatibilité avec l'éditeur de blocs
        ['__block_editor_compatible_meta_box' => true]
    );
});

Étape 4 : désactiver l’éditeur de blocs pour vérifier

// functions.php — désactiver l'éditeur de blocs pour un type de contenu donné
add_filter('use_block_editor_for_post_type', function($use_block_editor, $post_type) {
    if ($post_type === 'post') {
        return false;  // Passer à l'éditeur classique
    }
    return $use_block_editor;
}, 10, 2);

Vous pouvez aussi installer l'extension « Classic Editor » et la configurer depuis l'administration.

Étape 5 : déboguer l’affichage de la méta-boîte

// Vérifier que les méta-boîtes sont enregistrées
add_action('add_meta_boxes', function() {
    global $wp_meta_boxes;
    error_log('Meta boxes: ' . print_r(array_keys($wp_meta_boxes), true));
}, 999);  // Priorité 999 : exécuté en dernier

Étape 6 : vérifier les conflits d’extensions

# Désactiver toutes les extensions avec WP-CLI et vérifier la méta-boîte
wp plugin deactivate --all
# Ouvrir l'écran d'édition d'un article dans le navigateur et vérifier que la méta-boîte apparaît
# Si tout va bien, réactiver les extensions une par une pour identifier la responsable
wp plugin activate plugin-name

Étape 7 : réinitialiser les métadonnées de l’utilisateur

Les réglages des Options de l'écran sont enregistrés dans les métadonnées de l'utilisateur.

// Réinitialiser les réglages d'affichage des méta-boîtes d'un utilisateur
delete_user_meta(get_current_user_id(), 'metaboxhidden_post');
delete_user_meta(get_current_user_id(), 'metaboxhidden_page');

Points d’attention

• Les réglages des Options de l'écran sont enregistrés par utilisateur. Les autres utilisateurs doivent les régler séparément.
• Dans l'éditeur de blocs, seules les méta-boîtes du contexte side s'affichent dans la colonne latérale.
• Avec ACF (Advanced Custom Fields), il faut un réglage du groupe de champs compatible avec l'éditeur de blocs.

Résumé

Si une méta-boîte ne s'affiche pas, vérifiez d'abord les cases des « Options de l'écran ». Dans l'éditeur de blocs, le réglage __block_editor_compatible_meta_box est nécessaire. Si le problème persiste, isolez un éventuel conflit d'extensions. Articles associés : Quand un champ personnalisé ne s'enregistre pas, Quand l'éditeur de blocs plante

Une question sur WordPress ? L'éditeur de ce site est basé au Japon et répond en japonais. Contact (en japonais)