Blocos full-stack
Banco de dados, funções de servidor, cron e CLI em uma pasta.
db.php
Defina o esquema e obtenha endpoints CRUD
<?php
return [
'storage' => 'sqlite',
'userScoped' => true,
'capability' => [
'create' => true,
'read' => true,
'update' => true,
'delete' => true,
],
'fields' => [
'text' => ['type' => 'string', 'required' => true],
'done' => ['type' => 'boolean', 'default' => false],
],
];rpc.php
Funções personalizadas no servidor
<?php
use Blockstudio\Db;
return [
'toggle' => function (array $params): array {
$db = Db::get('my-theme/todo');
$id = (int) ($params['id'] ?? 0);
$todo = $db->get_record($id);
if ($todo) {
$db->update($id, ['done' => !$todo['done']]);
}
return ['success' => (bool) $todo];
},
'clear_done' => function (): array {
$db = Db::get('my-theme/todo');
foreach ($db->list(['done' => true], 500) as $todo) {
$db->delete((int) $todo['id']);
}
return ['cleared' => true];
},
];Cada recurso é um arquivo
Cada arquivo adiciona um recurso. Sem configuração nem código de registro.
Bloco de aplicativo
blockstudio/
└── my-app/
├── block.json Definição do bloco
├── index.php Modelo + Interactivity API
├── style.css Estilos com escopo definido
├── script-inline.js Lógica do cliente
├── db.php Modelo de dados + CRUD
├── rpc.php Funções do servidor
├── cron.php Tarefas agendadas
└── db/default.sqlite
Banco de dados
Defina esquemas e obtenha endpoints CRUD.
6 modos de armazenamento
table, sqlite, jsonc, storh, meta, post_type. Escolha conforme a portabilidade e as necessidades de consulta.
arquivos de Storh
Um arquivo por registro em uploads, com índices criados a partir do esquema e gravações simultâneas mais seguras. wp bs db migrate –to=storh migra registros de JSONC e mantém seus IDs.
Tabelas e tipos de post
O armazenamento em tabela gerencia uma tabela MySQL com dbDelta e adiciona colunas para novos campos. O armazenamento post_type transforma cada registro em um post, que WP_Query, plugins REST API e ferramentas GraphQL podem ler.
Vários esquemas
Retorne esquemas nomeados de um único db.php. Cada um tem seu próprio armazenamento, endpoints e controle de acesso.
Dados vinculados ao usuário
Defina userScoped para isolar registros automaticamente, sem filtragem manual.
Validação e hooks
Tipos, valores obrigatórios, enums, formatos, comprimentos, callbacks e hooks de ciclo de vida.
RPC
Funções de servidor que podem ser chamadas pelo frontend.
Camada de dados do cliente
Leia, armazene em cache e grave registros pelo navegador.
cliente bs.db()
Crie, liste, obtenha, atualize e exclua registros de JavaScript. list aceita filtros por campo, limite e deslocamento.
bs.query()
Buscas em cache por chave. Chamadas em andamento compartilham uma promessa, e staleTime ignora a solicitação enquanto os dados estiverem atualizados.
bs.mutate()
Criação, atualização e exclusão otimistas em um array de estado reativo, restaurado para um instantâneo quando a solicitação falha.
bs.cache
O cache em memória por trás de bs.query() e bs.mutate(). Leia, defina, invalide ou limpe entradas diretamente.
Consulta periódica em tempo real
Ative o modo em tempo real em db.php; o cliente compara um hash dos dados em intervalos e, em seguida, atualiza o armazenamento de Interactivity API. A consulta é pausada em abas ocultas.
Páginas em cache
bs.fn() e bs.db() buscam credenciais atualizadas em um endpoint sem cache na primeira chamada, para que chamadas públicas continuem funcionando em páginas servidas por caches de longa duração.
Formulários e telas do app
Formulários renderizados a partir do esquema e UI integrados para servir de base.
Formulários do esquema
Defina uma chave de componente para um campo e bs_db_form() renderizará o formulário por meio desses blocos, passando a definição do campo para cada um.
Formulário incluído
Com ui.enabled, bsui/form block=”…” envia os campos para o endpoint de criação desse bloco, mostra cada erro de validação abaixo do campo correspondente e dispara formSuccess ou formError.
Apps de exemplo
A configuração ui também registra os exemplos app/*, como app/kitchen-sink e app/chat, criados com os mesmos componentes bsui.
Infraestrutura
Cron, CLI, código de configuração e portabilidade.
Tarefas agendadas
Tarefas cron.php são registradas com WP-Cron. As instalações de Composer as removem com wp bs teardown.
CLI de banco de dados
wp bs db lista registros com filtros por campo, permite obtê-los, criá-los, atualizá-los e excluí-los, e exibe tabelas, JSON ou CSV.
Teste pelo terminal
wp bs rpc call executa uma função com parâmetros –key=value, e wp bs cron run executa um trabalho agora, independentemente da programação.
Arquivos de inicialização
init.php e outros arquivos init*.php em uma pasta de bloco são executados uma vez em init, para tarefas de configuração, como registrar um tipo de post.
Definições nativas de PHP
rpc.php e cron.php podem retornar uma classe com métodos #[Rpc] e #[Cron], além dos enums Access, Method e Schedule. db.php pode usar Schema::make() e construtores Field.
Portabilidade
SQLite e JSONC acompanham o código: copie uma pasta para implantar o aplicativo.
O kit oficial de extensões
Modelos premium de site, instruções de sistema para IA e uma comunidade privada Discord. Compra única, atualizações vitalícias.
- 500+ modelos de sites
- Instruções de sistema para IA
- Atualizações vitalícias
- Comunidade privada de Discord