Bloques de pila completa
Base de datos, funciones del servidor, cron y CLI en una carpeta.
db.php
Define un esquema y obtén puntos de conexión 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
Funciones personalizadas del 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 capacidad es un archivo
Cada archivo añade una capacidad. Sin configuración ni código de registro.
Bloque de aplicación
blockstudio/
└── my-app/
├── block.json Definición del bloque
├── index.php Plantilla + Interactividad API
├── style.css Estilos con ámbito
├── script-inline.js Lógica del cliente
├── db.php Modelo de datos + CRUD
├── rpc.php Funciones del servidor
├── cron.php Tareas programadas
└── db/default.sqlite
Base de datos
Define esquemas y obtén endpoints CRUD.
6 modos de almacenamiento
table, sqlite, jsonc, storh, meta, post_type. Elige según la portabilidad y las necesidades de consulta.
Archivos Storh
Un archivo por registro en uploads, con índices creados a partir del esquema y escrituras simultáneas más seguras. wp bs db migrate –to=storh transfiere JSONC registros y conserva sus ID.
Tablas y tipos de contenido
El almacenamiento en tabla gestiona una tabla MySQL con dbDelta y añade columnas para los campos nuevos. El almacenamiento post_type convierte cada registro en una entrada, para que WP_Query, los plugins REST API y las herramientas GraphQL puedan leerlo.
Varios esquemas
Devuelve esquemas con nombre desde un db.php. Cada uno tiene su propio almacenamiento, endpoints y control de acceso.
Datos aislados por usuario
Activa userScoped para aislar registros automáticamente, sin filtros manuales.
Validación y hooks
Tipos, valores obligatorios, enumeraciones, formatos, longitudes, funciones de retorno y hooks del ciclo de vida.
RPC
Funciones del servidor invocables desde el frontend.
Cliente bs.fn()
Invoca funciones desde JavaScript; los scripts en línea detectan automáticamente el nombre del bloque.
Control de acceso
Público con CSRF, abierto para webhooks o basado en capacidades, por función.
Llamadas entre bloques
Invoca cualquier función de bloque desde JavaScript o PHP y combina la lógica.
Capa de datos del cliente
Lee, almacena en caché y escribe registros desde el navegador.
cliente bs.db()
Crea, enumera, obtiene, actualiza y elimina registros desde JavaScript. list acepta filtros de campo, límite y desplazamiento.
bs.query()
Solicitudes fetch almacenadas en caché por clave. Las llamadas en curso comparten una promesa y staleTime omite la solicitud mientras los datos siguen vigentes.
bs.mutate()
Creación, actualización y eliminación optimistas en una matriz de estado reactiva, con reversión a una instantánea si falla la solicitud.
bs.cache
La caché en memoria detrás de bs.query() y bs.mutate(). Lee, establece, invalida o borra entradas directamente.
Sondeo en tiempo real
Activa el tiempo real en db.php y el cliente compara un hash de datos a intervalos, luego actualiza el almacén de Interactivity API. El sondeo se pausa en las pestañas ocultas.
Páginas en caché
bs.fn() y bs.db() obtienen credenciales nuevas desde un endpoint sin caché en la primera llamada, para que las llamadas públicas sigan funcionando en páginas servidas desde cachés de larga duración.
Formularios y pantallas de aplicaciones
Formularios generados a partir del esquema y UI incluidos para construir sobre ellos.
Formularios de esquema
Asigna una clave de componente a un campo y bs_db_form() genera el formulario mediante esos bloques, pasando a cada uno la definición del campo.
Formulario incluido
Con ui.enabled, bsui/form block=”…” envía sus campos al endpoint de creación de ese bloque, muestra cada error de validación debajo del campo correspondiente y activa formsuccess o formerror.
Aplicaciones de ejemplo
La opción ui también registra los ejemplos app/*, como app/kitchen-sink y app/chat, creados con los mismos componentes bsui.
Infraestructura
Cron, CLI, código de configuración y portabilidad.
Tareas programadas
Los trabajos cron.php se registran con WP-Cron. Las instalaciones de Composer los eliminan con wp bs teardown.
CLI de base de datos
wp bs db enumera registros con filtros de campo y permite obtenerlos, crearlos, actualizarlos y eliminarlos; además, imprime tablas, JSON o CSV.
Prueba desde la terminal
wp bs rpc call ejecuta una función con parámetros –key=value, y wp bs cron run ejecuta una tarea ahora, independientemente de su programación.
Archivos de inicialización
init.php y otros archivos init*.php de una carpeta de bloque se ejecutan una vez durante init, para tareas de configuración como registrar un tipo de contenido.
Definiciones nativas de PHP
rpc.php y cron.php pueden devolver una clase con métodos #[Rpc] y #[Cron], y con los enums Access, Method y Schedule. db.php puede usar Schema::make() y constructores Field.
Portabilidad
SQLite y JSONC viajan con el código: copia una carpeta para desplegar la aplicación.
El kit oficial de extensiones
Plantillas de sitio prémium, instrucciones de sistema para IA y una comunidad privada de Discord. Compra única, actualizaciones de por vida.
- Más de 500 plantillas de sitios web
- Instrucciones del sistema de IA
- Actualizaciones de por vida
- Comunidad privada de Discord