WordPress-Metabox wird nicht angezeigt: Ursachen und Lösung

Dieser Artikel ist eine lokalisierte Fassung des japanischen Originals. Japanisches Original lesen

Einleitung

Eine per Plugin hinzugefügte Metabox erscheint nicht im Bearbeitungsbildschirm, eine zuvor sichtbare Metabox ist plötzlich verschwunden, oder nach dem Wechsel zum Block-Editor taucht die Metabox in der Seitenleiste nicht mehr auf. Hinter einer fehlenden Metabox stecken die Bildschirmeinstellungen oder die Kompatibilität mit dem Block-Editor.

Symptome und Ursachen

Die wichtigsten Gründe, warum eine Metabox nicht angezeigt wird:

• Über „Ansicht anpassen“ (Screen Options) ausgeblendet: Die Anzeigeeinstellung des jeweiligen Benutzers steht auf „ausgeblendet“
• Inkompatibel mit dem Block-Editor: Die Einstellung __block_editor_compatible_meta_box ist erforderlich
• Problem mit der Hook-Priorität: Das Timing des Hooks add_meta_boxes passt nicht
• Falscher Beitragstyp: Der Beitragstyp im dritten Argument ist falsch
• Plugin-Konflikt: Ein anderes Plugin entfernt die Metabox

Lösung Schritt für Schritt

Schritt 1: „Ansicht anpassen“ prüfen

Die häufigste Ursache ist das Ausblenden über „Ansicht anpassen“.

1. Klicken Sie im Bearbeitungsbildschirm oben rechts auf „Ansicht anpassen“

2. Prüfen Sie, ob das Häkchen bei der gewünschten Metabox entfernt wurde

3. Setzen Sie das Häkchen und schließen Sie das Fenster, dann wird die Metabox angezeigt

Schritt 2: Die Implementierung von add_meta_box prüfen

// functions.php — Eine Metabox korrekt hinzufügen
add_action('add_meta_boxes', function() {
    add_meta_box(
        'my_meta_box_id',       // ID (eindeutige Zeichenkette)
        'Eigene Informationen',  // Titel
        'render_my_meta_box',   // Callback-Funktion
        ['post', 'page'],       // Beitragstyp (mehrere als Array möglich)
        'normal',               // Kontext: normal/side/advanced
        'high'                  // Priorität: 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) . '">';
}

Schritt 3: Die Metabox im Block-Editor anzeigen

Der Block-Editor (Gutenberg) unterstützt Metaboxen nur eingeschränkt.

// Die Metabox auch im Block-Editor anzeigen
add_action('add_meta_boxes', function() {
    add_meta_box(
        'my_meta_box_id',
        'Eigene Informationen',
        'render_my_meta_box',
        'post',
        'normal',
        'high',
        // Kompatibilität mit dem Block-Editor ausdrücklich angeben
        ['__block_editor_compatible_meta_box' => true]
    );
});

Schritt 4: Zur Kontrolle den Block-Editor deaktivieren

// functions.php — Den Block-Editor für einen bestimmten Beitragstyp deaktivieren
add_filter('use_block_editor_for_post_type', function($use_block_editor, $post_type) {
    if ($post_type === 'post') {
        return false;  // Zum Classic Editor wechseln
    }
    return $use_block_editor;
}, 10, 2);

Alternativ können Sie das Plugin „Classic Editor“ installieren und im Admin-Bereich einstellen.

Schritt 5: Die Anzeige der Metabox debuggen

// Prüfen, ob die Metabox registriert ist
add_action('add_meta_boxes', function() {
    global $wp_meta_boxes;
    error_log('Meta boxes: ' . print_r(array_keys($wp_meta_boxes), true));
}, 999);  // Mit Priorität 999 zuletzt ausführen

Schritt 6: Auf Plugin-Konflikte prüfen

# Mit WP-CLI alle Plugins deaktivieren und die Metabox prüfen
wp plugin deactivate --all
# Im Browser den Bearbeitungsbildschirm öffnen und prüfen, ob die Metabox erscheint
# Wenn alles in Ordnung ist, die Plugins einzeln wieder aktivieren und den Verursacher eingrenzen
wp plugin activate plugin-name

Schritt 7: User-Meta zurücksetzen

Die Einstellungen aus „Ansicht anpassen“ werden in den User-Metadaten gespeichert.

// Die Anzeigeeinstellungen der Metaboxen eines bestimmten Benutzers zurücksetzen
delete_user_meta(get_current_user_id(), 'metaboxhidden_post');
delete_user_meta(get_current_user_id(), 'metaboxhidden_page');

Hinweise

• Die Einstellungen aus „Ansicht anpassen“ werden pro Benutzer gespeichert. Andere Benutzer müssen sie jeweils selbst vornehmen.
• Im Block-Editor werden nur Metaboxen mit dem Kontext side in der Seitenleiste angezeigt.
• Wenn Sie ACF (Advanced Custom Fields) verwenden, ist eine für den Block-Editor geeignete Einstellung der Feldgruppe erforderlich.

Fazit

Wenn eine Metabox nicht angezeigt wird, prüfen Sie zuerst die Häkchen unter „Ansicht anpassen“. Im Block-Editor ist die Einstellung __block_editor_compatible_meta_box nötig. Hilft das nicht, grenzen Sie einen Plugin-Konflikt ein. Ähnliche Artikel: Wenn benutzerdefinierte Felder nicht gespeichert werden, Wenn der Block-Editor abstürzt

Fragen zu WordPress? Der Betreiber dieser Seite sitzt in Japan und antwortet auf Japanisch. Kontakt (Japanisch)