Zum Inhalt springen

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_options verfügt
  • die Seite über blockstudio/admin/enabled aktiviert ist

Deaktiviere sie vollständig mit:

PHP
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:

JSON
{
  "$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:

  1. werden die Schemainformationen vorab lokalisiert
  2. werden Einträge bei Bedarf abgerufen, wenn du einen Datenbank-Tab öffnest
  3. 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.