Zum Inhalt springen

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

  1. Blockentwickler veröffentlichen eine registry.json an einem URL, in der ihre verfügbaren Blöcke aufgeführt sind.
  2. Du fügst deiner Theme- oder Plugin-Konfiguration eine blocks.json hinzu, die auf die Registries verweist, die du verwenden möchtest.
  3. Du führst npx blockstudio add ui/tabs aus, 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 mit edit.js, save.js usw.
  • Einfache PHP-Blöcke: alle Blöcke, die mit register_block_type() registriert sind
  • Statische Blöcke: Blöcke mit nur einem block.json und 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

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Die vollständige Einrichtung findest du unter Erste Schritte.