Benutzerdefinierte Gutenberg-Blöcke fehlen oder funktionieren nicht

Benutzerdefinierte Gutenberg-Blöcke können das WordPress-Bearbeitungserlebnis verbessern, indem sie zusätzliche Layouts, Inhaltselemente und Funktionen bereitstellen. Wenn diese Blöcke plötzlich verschwinden, nicht geladen werden oder nicht mehr korrekt funktionieren, liegt das Problem meist an Plugin-Kompatibilität, veralteten Block-Bibliotheken, Caching oder JavaScript-Konflikten.

Dieser Leitfaden erklärt die häufigsten Ursachen und zeigt Schritt für Schritt, wie Sie Ihre benutzerdefinierten Blöcke wiederherstellen.

Wenn der gesamte Editor nicht lädt statt nur einzelner Blöcke, siehe Der Block-Editor (Gutenberg) lädt nicht.

Häufige Symptome

Wenn Sie Probleme mit benutzerdefinierten Blöcken haben, bemerken Sie möglicherweise eines oder mehrere der folgenden Probleme:

• Benutzerdefinierte Blöcke erscheinen nicht mehr im Block-Inserter.
• Bestehende Blöcke zeigen „Dieser Block enthält unerwarteten oder ungültigen Inhalt.“
• Blöcke erscheinen als nicht unterstützt oder nicht verfügbar.
• Blöcke werden im Editor nicht gerendert.
• Der Editor zeigt beim Verwenden benutzerdefinierter Blöcke Ladefehler an.
• Block-Einstellungen fehlen in der Seitenleiste.
• Früher erstellte Seiten zeigen fehlerhafte oder fehlende Layouts.
• Das Frontend zeigt Blockfehler oder fehlende Inhalte an.

Häufige Ursachen

Probleme mit benutzerdefinierten Blöcken werden meist durch eines der folgenden Dinge verursacht:

• Ein veraltetes Block-Plugin.
• Ein Plugin-Konflikt.
• Theme-Kompatibilitätsprobleme.
• JavaScript-Fehler.
• Zwischengespeicherte JavaScript- oder CSS-Dateien.
• Beschädigte Plugin-Dateien.
• Deaktivierte REST-API-Funktionalität.
• Änderungen am Code benutzerdefinierter Blöcke nach einem Plugin-Update.
• Fehlende oder beschädigte WordPress-Kerndateien.

Lösung 1: Ihr Block-Plugin aktualisieren

Viele benutzerdefinierte Blöcke werden von Plugins bereitgestellt. Wenn das Plugin nicht kürzlich aktualisiert wurde, ist es möglicherweise nicht mehr vollständig mit der neuesten WordPress-Version kompatibel.

Aktualisieren Sie das Plugin auf die neueste verfügbare Version und testen Sie die betroffenen Blöcke erneut.

Wenn mehrere Block-Plugins installiert sind, aktualisieren Sie alle, bevor Sie mit weiteren Schritten zur Fehlerbehebung fortfahren.

Lösung 2: Prüfen, ob das Plugin aktiv ist

Es klingt vielleicht offensichtlich, aber benutzerdefinierte Blöcke verschwinden sofort, wenn das Plugin, das sie bereitstellt, deaktiviert wurde.

Gehen Sie zu Plugins → Installierte Plugins und bestätigen Sie, dass das Block-Plugin aktiv ist.

Wenn das Plugin versehentlich deaktiviert wurde, aktivieren Sie es erneut und laden Sie den Editor neu.

Lösung 3: Alle Caches leeren

Alte zwischengespeicherte JavaScript- und CSS-Dateien können verhindern, dass benutzerdefinierte Blöcke korrekt geladen werden.

Leeren Sie:

• den Browser-Cache.
• den WordPress-Cache.
• den Server-Cache.
• den CDN-Cache.
• den Object Cache.

Führen Sie nach dem Leeren des Caches einen Hard Refresh durch und öffnen Sie den Editor erneut.

Lösung 4: Auf Plugin-Konflikte prüfen

Wenn die Aktualisierung des Block-Plugins das Problem nicht behebt, stört möglicherweise ein anderes Plugin die Funktion.

Deaktivieren Sie vorübergehend alle Plugins außer dem Block-Plugin.

Wenn die Blöcke dann wieder funktionieren:

1. Aktivieren Sie die Plugins nacheinander wieder.
2. Testen Sie den Editor nach jeder Aktivierung.
3. Ermitteln Sie, welches Plugin den Konflikt verursacht.

Aktualisieren, ersetzen oder entfernen Sie das konfliktverursachende Plugin, sobald Sie es identifiziert haben.

Lösung 5: Auf ein Standard-Theme wechseln

Einige Themes enthalten benutzerdefiniertes JavaScript oder CSS, das Gutenberg beeinflusst.

Aktivieren Sie vorübergehend ein Standard-WordPress-Theme.

Wenn die benutzerdefinierten Blöcke dann funktionieren, ist sehr wahrscheinlich Ihr Theme die Ursache.

Aktualisieren Sie das Theme oder wenden Sie sich an den Entwickler, um eine kompatible Version zu erhalten.

Lösung 6: Die Browser-Konsole prüfen

JavaScript-Fehler verhindern oft, dass benutzerdefinierte Blöcke korrekt geladen werden.

So prüfen Sie Fehler:

1. Öffnen Sie den Editor.
2. Drücken Sie F12.
3. Wählen Sie den Tab Konsole.
4. Laden Sie die Seite neu.

Achten Sie auf Fehlerhinweise zu:

• fehlenden JavaScript-Dateien.
• Plugin-Skripten.
• Fehlern bei der Block-Registrierung.
• REST-API-Anfragen.
• React-Fehlern.

Diese Meldungen können helfen, die Problemquelle einzugrenzen.

Lösung 7: Die REST API prüfen

Viele Gutenberg-Blöcke verlassen sich auf die WordPress REST API, um Einstellungen und Inhalte abzurufen.

Rufen Sie folgende Adresse auf:

https://yourdomain.com/wp-json/

Wenn die Seite keine gültige JSON-Antwort zurückgibt, kann die REST API blockiert sein.

Häufige Ursachen sind:

• Sicherheits-Plugins.
• Firewall-Regeln.
• Serverkonfiguration.
• Falsche Permalink-Einstellungen.

Die Behebung von REST-API-Problemen stellt fehlende Blöcke oft wieder her.

Lösung 8: Das Block-Plugin neu installieren

Plugin-Dateien können bei einem Update gelegentlich beschädigt werden.

So installieren Sie das Plugin sicher neu:

1. Exportieren Sie, sofern unterstützt, alle plugin-spezifischen Einstellungen.
2. Löschen Sie das vorhandene Plugin.
3. Installieren Sie die neueste Version.
4. Aktivieren Sie das Plugin.
5. Testen Sie die betroffenen Blöcke.

Die meisten gut entwickelten Plugins behalten ihre Einstellungen bei einer Neuinstallation, trotzdem ist vorher ein Backup immer eine gute Idee.

Lösung 9: Auf ungültigen Block-Inhalt prüfen

Wenn bestehende Seiten die Meldung „Dieser Block enthält unerwarteten oder ungültigen Inhalt.“ anzeigen, kann sich die Blockstruktur nach einem Update geändert haben.

In vielen Fällen bietet WordPress die folgenden Optionen an:

• Block-Wiederherstellung versuchen.
• Den Block in HTML umwandeln.
• Den Block manuell reparieren.

Vergleichen Sie vor dem Übernehmen von Änderungen die Vorschau, damit Ihre Inhalte intakt bleiben.

Lösung 10: Aus einem Backup wiederherstellen

Wenn das Problem direkt nach einem Plugin-Update oder einer Änderung an Ihrer Website begonnen hat, kann das Wiederherstellen eines aktuellen Backups die schnellste Lösung sein.

Stellen Sie Folgendes wieder her:

• Website-Dateien.
• Datenbank.
• Plugin-Dateien.

Aktualisieren Sie danach die Plugins nacheinander und testen Sie Ihre benutzerdefinierten Blöcke zwischen den Updates.

Best Practices

So vermeiden Sie künftig Probleme mit benutzerdefinierten Blöcken:

• Halten Sie Ihre Block-Plugins aktuell.
• Entfernen Sie Block-Plugins, die Sie nicht mehr verwenden.
• Vermeiden Sie die Installation mehrerer Plugins, die ähnliche Block-Sammlungen bereitstellen.
• Testen Sie Plugin-Updates auf einer Staging-Website, bevor Sie sie auf Ihrer Live-Website anwenden.
• Halten Sie WordPress, Themes und Plugins aktuell.
• Erstellen Sie vor größeren Updates regelmäßige Backups.
• Prüfen Sie die Änderungsprotokolle der Plugins auf Breaking Changes, bevor Sie aktualisieren.

Wenn Sie diese Best Practices befolgen, bleiben Ihre benutzerdefinierten Gutenberg-Blöcke stabil und funktionsfähig, und das Risiko fehlender Inhalte oder Editor-Probleme in Zukunft wird reduziert.