Eigene Gutenberg-Blöcke als WordPress-Plugin entwickeln
Wiederkehrende Inhalte erhalten mit eigenen Gutenberg-Blöcken eine passende Eingabeoberfläche im WordPress-Editor. Der offizielle Block-Generator und eine gemeinsam gepflegte Plugin-Basis schaffen dafür eine verlässliche Struktur für Entwicklung und Weiterverwendung.
Ein eigener Gutenberg-Block erweitert den WordPress-Editor um einen Inhaltsbaustein für wiederkehrende Aufgaben. Dazu gehören beispielsweise strukturierte Linklisten, Bildvergleiche, Projektvorschauen oder Formulare. Als eigenständiges Plugin bleibt die Funktion vom aktiven Theme getrennt und lässt sich in weiteren Projekten einsetzen.
WordPress stellt mit @wordpress/create-block einen offiziellen Generator bereit. Er erstellt ein startfähiges Block-Plugin mit der benötigten Projektstruktur, einer block.json-Datei sowie Dateien für Editor, Website und Build-Prozess.
Ein neues Block-Plugin anlegen
Im Terminal wird der Generator im gewünschten Arbeitsverzeichnis ausgeführt. Der Name bildet zugleich die Grundlage für den Plugin-Ordner und die Block-Registrierung.
npx @wordpress/create-block projekt-karte
Der Generator fragt Bezeichnung und Ausrichtung des Blocks ab. Danach liegt ein vollständiges Plugin-Projekt vor, das in einer lokalen WordPress-Installation aktiviert werden kann.
Die zentrale Blockbeschreibung
Die Datei block.json beschreibt den Block für WordPress. Sie enthält unter anderem Name, Titel, Kategorie, Icon, unterstützte Einstellungen sowie die dazugehörigen Skripte und Styles.
{
"apiVersion": 3,
"name": "ud/projekt-karte",
"title": "Projektkarte",
"category": "widgets",
"editorScript": "file:./index.js",
"style": "file:./style-index.css"
}
Im Ordner src liegen die Quelldateien. Dort entsteht die Bearbeitungsoberfläche im Editor und die Ausgabe auf der Website. Der Build-Prozess erstellt daraus die optimierten Dateien im Ordner build.

block.json, Quellcode und Build-Dateien mit dem fertigen Block im WordPress-Editor.Block im Editor entwickeln
Während der Entwicklung überwacht der Build-Prozess die Quelldateien. Änderungen an JavaScript, Styles und Block-Metadaten stehen dadurch direkt für die weitere Arbeit bereit.
cd projekt-karte
npm start
Nach der Aktivierung erscheint der Block im Inserter und lässt sich wie jeder andere Gutenberg-Block einfügen. Die Vorschau im Editor verbindet Inhaltsstruktur, Einstellungen und Gestaltung mit der späteren redaktionellen Arbeit.
Plugin für die Website bauen
Vor der Bereitstellung erstellt der Build-Prozess die Dateien für den Einsatz auf der Website.
npm run build
Das Plugin kann anschliessend im WordPress-Admin installiert und aktiviert werden. Für eine ZIP-Datei stellt @wordpress/scripts einen passenden Befehl bereit:
npm run plugin-zip
Gemeinsame Basis für neue Block-Plugins
Für wiederkehrende Entwicklungsaufgaben pflegen wir mit dem UD Blank Block eine vorbereitete Plugin-Basis. Sie bündelt block.json, die PHP-Registrierung sowie getrennte Bereiche für Hilfs- und Renderfunktionen. JavaScript- und SCSS-Dateien für Editor und Website bleiben ebenfalls voneinander getrennt.
Die Webpack-Konfiguration erzeugt eigene Ausgabedateien für Editor-Skript, Frontend-Skript und beide Stylesheets. Über @svgr/webpack stehen SVG-Grafiken als React-Komponenten für die Block-Oberfläche bereit. Neue Block-Plugins beginnen damit auf einer einheitlichen technischen Grundlage und erhalten anschliessend ihre projektspezifischen Attribute, Bedienelemente, Ausgabelogik und Gestaltung.
Der UD Blank Block dokumentiert diese Ausgangsbasis im GitHub-Repository und macht die wiederverwendbare Struktur nachvollziehbar.
Wiederkehrende Inhalte als Block gestalten
Ein eigener Block verbindet Gestaltung, Inhaltsstruktur und redaktionelle Eingabe in einer gemeinsamen Funktion. Für wiederkehrende Inhalte steht dadurch eine passende Oberfläche mit verständlichen Optionen bereit. So entstehen WordPress-Lösungen, die sich in den redaktionellen Alltag und das jeweilige Designsystem einfügen. Benötigt der Baustein eine feste innere Struktur, lassen sich eigene WordPress-Blöcke mit InnerBlocks strukturieren.
Ergebnis
Eine verlässliche Basis für eigene Gutenberg-Funktionen
Der offizielle Generator schafft den Einstieg in ein Block-Plugin. Die gemeinsame Plugin-Basis ergänzt ihn um eine Struktur für wiederkehrende Entwicklungsaufgaben und projektspezifische Erweiterungen.
Block-Plugin starten
Der Generator erstellt ein startfähiges Projekt mit den erforderlichen WordPress-Dateien.
Gemeinsame Struktur nutzen
Die Plugin-Basis trennt Registrierung, Editor, Website und Hilfsfunktionen übersichtlich.
Inhalte redaktionell pflegen
Eigene Blöcke verbinden wiederkehrende Inhalte mit einer passenden Oberfläche im Editor.