Vai al contenuto

Amministrazione

Blockstudio include una schermata di amministrazione in Strumenti > Blockstudio. È una vista di ispezione a livello di progetto di ciò che Blockstudio ha registrato dal filesystem, oltre a un browser per registri e record del database.

Questa non è una pagina delle impostazioni, per scelta. L’obiettivo è offrire visibilità su quali blocchi, estensioni, campi, pagine, schemi, registri e record del database esistono al momento.

Accesso

La pagina di amministrazione è disponibile quando sono soddisfatte entrambe le condizioni seguenti:

  • l’utente corrente dispone della capability manage_options
  • la pagina è abilitata tramite blockstudio/admin/enabled

Disabilitatela completamente con:

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

Viste

Panoramica

La panoramica è un inventario di sola lettura delle registrazioni di Blockstudio. Include schede dedicate a:

  • Blocchi: tipi di blocco registrati, modalità di rendering, versione di API, numero di attributi
  • Estensioni: destinazioni, priorità, modalità di rendering, numero di attributi
  • Campi: definizioni riutilizzabili di field.json
  • Pagine: pagine basate su file con tipo di post, stato, motore e stato di sincronizzazione
  • Schemi: schemi db.php registrati con conteggi di archiviazione e campi

Le tabelle usano i DataViews nativi di WordPress, così la schermata resta coerente con wp-admin senza introdurre un’interfaccia separata.

Registro

Se il progetto ha un blocks.json con registri configurati, la pagina di amministrazione mostra una vista Registro. Recupera i blocchi disponibili da quei registri e consente di importarli direttamente nella directory dei blocchi configurata.

La stessa configurazione di blocks.json alimenta sia CLI sia il browser di amministrazione:

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

I registri autenticati sono supportati tramite il formato oggetto con interpolazione di headers e ${ENV_VAR}. Per il formato di configurazione completo, consultate la documentazione dei Registri.

Database

Se il progetto registra schemi db.php, la pagina di amministrazione mostra una vista Database. Ogni schema ha una scheda dedicata che visualizza i record effettivi in una tabella DataViews.

La schermata non serializza tutti i record nel payload iniziale di amministrazione. Invece:

  1. i metadati dello schema vengono localizzati in anticipo
  2. i record vengono recuperati su richiesta quando aprite una scheda del database
  3. le tabelle vengono paginate tramite REST API

In questo modo la schermata di amministrazione resta utilizzabile anche quando il progetto ha dataset più grandi.

Ambito

L’ambito attuale è volutamente ristretto:

  • ispezionare ciò che Blockstudio ha registrato
  • importare blocchi dai registri configurati
  • consultare i record del database

Non sostituisce il flusso di lavoro delle impostazioni esistente e non modifica direttamente le definizioni di blocchi o pagine.