Admin
Blockstudio enthält einen Admin-Bildschirm unter Werkzeuge > Blockstudio. Er dient auf Projektebene dazu, zu prüfen, was Blockstudio aus dem Dateisystem registriert hat, und Registrierungen sowie Datenbankeinträge zu durchsuchen.
Dies ist absichtlich keine Einstellungsseite. Ziel ist es, sichtbar zu machen, welche Blöcke, Erweiterungen, Felder, Seiten, Schemas, Registrierungen und Datenbankeinträge aktuell vorhanden sind.
Zugriff
Die Admin-Seite ist verfügbar, wenn beide Bedingungen erfüllt sind:
- der aktuelle Benutzer über die Berechtigung
manage_optionsverfügt - die Seite über
blockstudio/admin/enabledaktiviert ist
Deaktiviere sie vollständig mit:
add_filter('blockstudio/admin/enabled', '__return_false');
Ansichten
Übersicht
Die Übersicht ist ein schreibgeschütztes Verzeichnis der Blockstudio-Registrierungen. Sie enthält eigene Tabs für:
- Blöcke: registrierte Blocktypen, Render-Modus, API-Version, Anzahl der Attribute
- Erweiterungen: Ziele, Priorität, Render-Modus, Anzahl der Attribute
- Felder: wiederverwendbare Definitionen für
field.json - Seiten: dateibasierte Seiten mit Beitragstyp, Status, Engine und Synchronisierungsstatus
- Schemas: registrierte
db.php-Schemas mit Speicher- und Feldanzahl
Die Tabellen verwenden native WordPress DataViews, damit die Ansicht mit wp-admin übereinstimmt, statt eine separate Oberfläche zu erfinden.
Registry
Wenn dein Projekt über ein blocks.json mit konfigurierten Registries verfügt, zeigt die Admin-Seite eine Ansicht Registry. Sie ruft die verfügbaren Blöcke aus diesen Registries ab und ermöglicht den direkten Import in das konfigurierte Blockverzeichnis.
Dieselbe blocks.json-Konfiguration steuert sowohl CLI als auch den Admin-Browser:
{
"$schema": "https://blockstudio.dev/schema/blocks.json",
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json"
}
}
Authentifizierte Registries werden über das Objektformat mit Interpolation von headers und ${ENV_VAR} unterstützt. Das vollständige Konfigurationsformat findest du in der Registry-Dokumentation.
Datenbanken
Wenn dein Projekt db.php-Schemas registriert, zeigt die Admin-Seite eine Ansicht Datenbanken. Jedes Schema erhält einen eigenen Tab, in dem tatsächliche Einträge in einer DataViews-Tabelle angezeigt werden.
Die Ansicht serialisiert nicht alle Einträge in die anfängliche Admin-Payload. Stattdessen:
- werden die Schemainformationen vorab lokalisiert
- werden Einträge bei Bedarf abgerufen, wenn du einen Datenbank-Tab öffnest
- blättern Tabellen durch die REST API
So bleibt die Admin-Ansicht auch bei größeren Datensätzen in einem Projekt nutzbar.
Geltungsbereich
Der aktuelle Funktionsumfang ist bewusst eng gefasst:
- ansehen, was Blockstudio registriert hat
- Blöcke aus konfigurierten Registries importieren
- Datenbankeinträge durchsuchen
Sie ersetzt weder den bestehenden Einstellungsablauf noch bearbeitet sie Block- oder Seitendefinitionen direkt.