Allgemeines
Die Blockstudio Registry ist ein CLI-Werkzeug zum Verteilen und Installieren von WordPress-Blöcken aus gehosteten Registries.
Es funktioniert wie shadcn/ui, aber für WordPress-Blöcke. Es gibt kein npm-Paket zum Installieren. Du führst einen Befehl aus, der Block-Quellcode wird in dein Projekt kopiert, und du hast die volle Kontrolle darüber.
So funktioniert es
- Blockentwickler veröffentlichen eine
registry.jsonan einem URL, in der ihre verfügbaren Blöcke aufgeführt sind. - Du fügst deiner Theme- oder Plugin-Konfiguration eine
blocks.jsonhinzu, die auf die Registries verweist, die du verwenden möchtest. - Du führst
npx blockstudio add ui/tabsaus, und der Blockordner landet in deinem Projekt.
Das ist alles. Die CLI lädt die Dateien herunter, löst Abhängigkeiten auf und schreibt sie auf die Festplatte. Sie wandelt nichts um. Ein WordPress-Blockordner ist überall gleich.
Unterstützte Inhalte
Die Registry ist unabhängig vom Blocktyp. Sie kopiert Ordner. Jeder Block, der in einem Verzeichnis liegt, funktioniert:
- Blockstudio-Blöcke:
block.json+ PHP/Twig/Blade-Vorlage + optionale Assets @wordpress/create-block-Blöcke: vollständige JS-Build-Ausgabe mitedit.js,save.jsusw.- Einfache PHP-Blöcke: alle Blöcke, die mit
register_block_type()registriert sind - Statische Blöcke: Blöcke mit nur einem
block.jsonund ohne serverseitiges Rendering
Der CLI ist egal, was sich im Ordner befindet. Er liest das Dateimanifest aus der Registry und lädt genau diese Dateien herunter.
WordPress-Administration
Wenn das aktive Theme eine blocks.json mit konfigurierten Registries hat, erscheinen dieselben Registries auch unter Werkzeuge > Blockstudio > Registry in wp-admin.
Mit dieser Admin-Ansicht kannst du die verfügbaren Blöcke prüfen und importieren, ohne die CLI anzufassen. Das Konfigurationsformat bleibt gleich. blocks.json bleibt die maßgebliche Quelle.
Schnellstart
npx blockstudio init
npx blockstudio add ui/tabs
Die vollständige Einrichtung findest du unter Erste Schritte.