Blocchi full stack
Database, funzioni server, cron e CLI in un’unica cartella.
db.php
Definisci lo schema, ottieni endpoint 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
Funzioni server personalizzate
<?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];
},
];Ogni funzionalità è un file
Ogni file aggiunge una funzionalità. Nessuna configurazione né codice di registrazione.
Blocco applicativo
blockstudio/
└── my-app/
├── block.json Definizione del blocco
├── index.php Template + Interactivity API
├── style.css Stili con ambito limitato
├── script-inline.js Logica lato client
├── db.php Modello dati + CRUD
├── rpc.php Funzioni server
├── cron.php Attività pianificate
└── db/default.sqlite
Database
Definisci schemi e ottieni endpoint CRUD.
6 modalità di archiviazione
table, sqlite, jsonc, storh, meta, post_type. Scegli in base alla portabilità e alle esigenze di query.
File Storh
Un file per record in uploads, con indici creati dallo schema e scritture simultanee più sicure. wp bs db migrate –to=storh trasferisce i record JSONC e ne mantiene gli ID.
Tabelle e tipi di contenuto
L’archiviazione in tabella gestisce una tabella MySQL con dbDelta e aggiunge colonne per i nuovi campi. L’archiviazione post_type crea un post per ogni record, così WP_Query, i plugin REST API e gli strumenti GraphQL possono leggerlo.
Più schemi
Restituisci schemi con nome da un unico db.php. Ognuno ha archiviazione, endpoint e controlli di accesso propri.
Dati associati all’utente
Imposta userScoped per isolare automaticamente i record, senza filtrarli manualmente.
Validazione e hook
Tipi, valori obbligatori, enumerazioni, formati, lunghezze, callback e hook del ciclo di vita.
RPC
Funzioni server richiamabili dal frontend.
Client bs.fn()
Richiama funzioni da JavaScript; gli script inline rilevano automaticamente il nome del blocco.
Controllo degli accessi
Pubblico con CSRF, aperto per webhook o basato su capability, per ogni funzione.
Chiamate tra blocchi
Richiama qualsiasi funzione di blocco da JavaScript o PHP e componi la logica.
Livello dati lato client
Leggi, memorizza nella cache e scrivi record dal browser.
Client bs.db()
Crea, elenca, recupera, aggiorna ed elimina record da JavaScript. list accetta filtri per campo, limite e offset.
bs.query()
Richieste fetch memorizzate nella cache per chiave. Le chiamate in corso condividono una promise e staleTime evita la richiesta finché i dati sono aggiornati.
bs.mutate()
Creazione, aggiornamento ed eliminazione ottimistici in un array di stato reattivo, ripristinato a uno snapshot se la richiesta non riesce.
bs.cache
La cache in memoria dietro bs.query() e bs.mutate(). Leggi, imposta, invalida o svuota direttamente le voci.
Polling in tempo reale
Imposta il tempo reale in db.php: il client confronta periodicamente un hash dei dati e aggiorna lo store Interactivity API. Il polling si interrompe nelle schede nascoste.
Pagine memorizzate nella cache
bs.fn() e bs.db() recuperano credenziali aggiornate da un endpoint non memorizzato nella cache alla prima chiamata, così le chiamate pubbliche continuano a funzionare sulle pagine servite da cache di lunga durata.
Moduli e schermate dell’app
Moduli generati dallo schema e UI integrati da cui partire.
Moduli basati sullo schema
Assegna a un campo una chiave componente e bs_db_form() genera il modulo tramite quei blocchi, passando a ciascuno la definizione del campo.
Modulo incluso
Con ui.enabled, bsui/form block=”…” invia i campi all’endpoint di creazione di quel blocco, mostra ogni errore di convalida sotto il relativo campo e attiva formsuccess o formerror.
App di esempio
Anche l’impostazione ui registra gli esempi app/*, come app/kitchen-sink e app/chat, realizzati con gli stessi componenti bsui.
Infrastruttura
Cron, CLI, codice di configurazione e portabilità.
Attività pianificate
I processi cron.php si registrano con WP-Cron. Le installazioni Composer li rimuovono con wp bs teardown.
CLI del database
wp bs db elenca i record con filtri per campo, li recupera, crea, aggiorna ed elimina e stampa tabelle, JSON o CSV.
Esegui i test dal terminale
wp bs rpc call esegue una funzione con parametri –key=value e wp bs cron run avvia subito un’attività, indipendentemente dalla sua pianificazione.
File di inizializzazione
init.php e gli altri file init*.php in una cartella di blocco vengono eseguiti una volta durante init, per attività di configurazione come la registrazione di un tipo di contenuto.
Definizioni native di PHP
rpc.php e cron.php possono restituire una classe con metodi #[Rpc] e #[Cron] e gli enum Access, Method e Schedule. db.php può usare Schema::make() e i builder Field.
Portabilità
SQLite e JSONC viaggiano con il codice: basta copiare una cartella per distribuire l’app.
Il kit ufficiale di estensioni
Template di siti premium, istruzioni di sistema per l’AI e una community privata Discord. Acquisto una tantum, aggiornamenti a vita.
- Oltre 500 modelli di siti
- Istruzioni di sistema per l’AI
- Aggiornamenti a vita
- Community privata di Discord