Saltar al contenido

Administración

Blockstudio incluye una pantalla de administración en Herramientas > Blockstudio. Es una vista de inspección a nivel de proyecto de lo que Blockstudio ha registrado desde el sistema de archivos, además de un explorador de registros y entradas de la base de datos.

Esta página no es una página de ajustes, por diseño. Su objetivo es ofrecer visibilidad: qué bloques, extensiones, campos, páginas, esquemas, registros y entradas de la base de datos existen ahora mismo.

Acceso

La página de administración está disponible cuando se cumplen estas dos condiciones:

  • el usuario actual tiene la capacidad manage_options
  • la página está habilitada mediante blockstudio/admin/enabled

Desactívela por completo con:

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

Vistas

Resumen

El resumen es un inventario de solo lectura de los registros de Blockstudio. Incluye pestañas específicas para:

  • Bloques: tipos de bloque registrados, modo de renderizado, versión de API, número de atributos
  • Extensiones: destinos, prioridad, modo de renderizado, número de atributos
  • Campos: definiciones reutilizables de field.json
  • Páginas: páginas basadas en archivos con tipo de contenido, estado, motor y estado de sincronización
  • Esquemas: esquemas de db.php registrados, con almacenamiento y número de campos

Las tablas usan DataViews nativas de WordPress para que la pantalla siga el estilo de wp-admin en lugar de crear una interfaz aparte.

Registro

Si su proyecto tiene un blocks.json con registros configurados, la página de administración muestra una vista Registro. Obtiene los bloques disponibles de esos registros y permite importarlos directamente al directorio de bloques configurado.

La misma configuración de blocks.json se usa tanto en CLI como en el explorador de administración:

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

Se admiten registros autenticados mediante el formato de objeto con interpolación de headers y ${ENV_VAR}. Consulte la documentación del registro para ver el formato completo de configuración.

Bases de datos

Si su proyecto registra esquemas db.php, la página de administración muestra una vista Bases de datos. Cada esquema tiene su propia pestaña y muestra registros reales en una tabla DataViews.

La pantalla no serializa todos los registros en la carga inicial de administración. En su lugar:

  1. Los metadatos del esquema se localizan de antemano.
  2. Los registros se obtienen bajo demanda al abrir una pestaña de base de datos.
  3. Las tablas paginan mediante REST API

Así, la pantalla de administración sigue siendo utilizable incluso cuando el proyecto tiene conjuntos de datos más grandes.

Alcance

El alcance actual es deliberadamente limitado:

  • inspeccionar lo que Blockstudio ha registrado
  • importar bloques desde los registros configurados
  • explorar los registros de la base de datos

No sustituye el flujo de trabajo de ajustes existente ni permite editar directamente las definiciones de bloques o páginas.