Pular para o conteúdo

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:

PHP
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.php registrados, 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:

JSON
{
  "$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:

  1. os metadados dos esquemas são localizados antecipadamente
  2. os registros são buscados sob demanda quando você abre uma aba do banco de dados
  3. 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.