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:
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.phpregistrados, 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:
{
"$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:
- Los metadatos del esquema se localizan de antemano.
- Los registros se obtienen bajo demanda al abrir una pestaña de base de datos.
- 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.