Gå til indhold

Administration

Blockstudio leveres med en administrationsside under Værktøjer > Blockstudio. Det er en inspektionsflade på projektniveau, der viser, hvad Blockstudio har registreret fra filsystemet, samt giver adgang til registre og databaseposter.

Dette er bevidst ikke en indstillingsside. Formålet er at give overblik over, hvilke blokke, udvidelser, felter, sider, skemaer, registre og databaseposter der findes lige nu.

Adgang

Administrationssiden er tilgængelig, når begge betingelser er opfyldt:

  • den aktuelle bruger har funktionen manage_options
  • siden er aktiveret via blockstudio/admin/enabled

Deaktiver den helt med:

PHP
add_filter('blockstudio/admin/enabled', '__return_false');

Visninger

Oversigt

Oversigten er en skrivebeskyttet fortegnelse over Blockstudio-registreringer. Den indeholder særskilte faner for:

  • Blokke: registrerede bloktyper, gengivelsestilstand, version af API, antal attributter
  • Udvidelser: mål, prioritet, gengivelsestilstand, antal attributter
  • Felter: genanvendelige definitioner af field.json
  • Sider: filbaserede sider med indlægstype, status, motor og synkroniseringstilstand
  • Skemaer: registrerede db.php-skemaer med antal lagre og felter

Tabellerne bruger de indbyggede WordPress DataViews, så skærmen følger wp-admins udtryk i stedet for at opfinde en separat brugerflade.

Register

Hvis dit projekt har en blocks.json med konfigurerede registre, viser administrationssiden en visning af Register. Den henter de tilgængelige blokke fra registrene og lader dig importere dem direkte til den konfigurerede blokmappe.

Den samme konfiguration af blocks.json driver både CLI og administrationssidens browser:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blocks.json",
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json"
  }
}

Godkendte registre understøttes via objektformatet med interpolation af headers og ${ENV_VAR}. Se dokumentationen til registre for det fulde konfigurationsformat.

Databaser

Hvis dit projekt registrerer skemaer for db.php, viser administrationssiden en visning af Databaser. Hvert skema får sin egen fane, hvor faktiske poster vises i en DataViews-tabel.

Skærmen serialiserer ikke alle poster i den indledende administrationsdata. I stedet:

  1. lokaliseres skemametadata på forhånd
  2. hentes poster efter behov, når du åbner en databasefane
  3. pagineres tabellerne gennem REST API

Det holder administrationsskærmen brugbar, selv når et projekt har større datasæt.

Omfang

Det aktuelle omfang er bevidst snævert:

  • undersøg, hvad Blockstudio har registreret
  • importer blokke fra konfigurerede registre
  • gennemse databaseposter

Det erstatter ikke den eksisterende arbejdsgang for indstillinger, og det redigerer ikke blok- eller sidedefinitioner direkte.