Administração
Blockstudio inclui uma tela de administração em Ferramentas > Blockstudio. É uma área de inspeção no nível do projeto que mostra o que Blockstudio registrou a partir do sistema de arquivos, além de permitir navegar por registros e dados do banco de dados.
Esta página não é uma página de configurações por definição. O objetivo é dar visibilidade ao que existe no momento: blocos, extensões, campos, páginas, esquemas, registros e dados do banco de dados.
Acesso
A página de administração fica disponível quando as duas condições a seguir são atendidas:
- o usuário atual tem a capacidade
manage_options - a página está habilitada por meio de
blockstudio/admin/enabled
Desative-a completamente com:
add_filter('blockstudio/admin/enabled', '__return_false');
Visualizações
Visão geral
A visão geral é um inventário somente para leitura dos registros de Blockstudio. Ela inclui abas dedicadas a:
- Blocos: tipos de bloco registrados, modo de renderização, versão de API, quantidade de atributos
- Extensões: alvos, prioridade, modo de renderização, quantidade de atributos
- Campos: definições reutilizáveis de
field.json - Páginas: páginas baseadas em arquivos com tipo de post, status, mecanismo e estado de sincronização
- Esquemas: esquemas
db.phpregistrados, com quantidades de armazenamento e campos
As tabelas usam os DataViews nativos de WordPress, mantendo a tela alinhada ao wp-admin em vez de criar uma interface separada.
Registro
Se o seu projeto tiver um blocks.json com registros configurados, a página de administração mostrará uma visualização Registro. Ela busca os blocos disponíveis nesses registros e permite importá-los diretamente para o diretório de blocos configurado.
A mesma configuração de blocks.json é usada tanto por CLI quanto pelo navegador de administração:
{
"$schema": "https://blockstudio.dev/schema/blocks.json",
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json"
}
}
Os registros autenticados são compatíveis com o formato de objeto que usa interpolação de headers e ${ENV_VAR}. Consulte a documentação de Registro para ver o formato completo de configuração.
Bancos de dados
Se o seu projeto registrar esquemas db.php, a página de administração mostrará uma visualização Bancos de dados. Cada esquema terá sua própria aba, que exibe registros reais em uma tabela DataViews.
A tela não serializa todos os registros no payload inicial de administração. Em vez disso:
- os metadados dos esquemas são localizados antecipadamente
- os registros são buscados sob demanda quando você abre uma aba do banco de dados
- as tabelas são paginadas pelas REST API
Assim, a tela de administração continua utilizável mesmo quando o projeto tem conjuntos de dados maiores.
Escopo
O escopo atual é intencionalmente restrito:
- inspecionar o que Blockstudio registrou
- importar blocos de registros configurados
- navegar pelos registros do banco de dados
Ela não substitui o fluxo de trabalho de configurações existente e não edita diretamente as definições de blocos ou páginas.