Blocuri full-stack
Baza de date, funcțiile de server, cron și CLI într-un singur folder.
db.php
Definiți schema, obțineți endpointuri 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
Funcții personalizate pentru server
<?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];
},
];Fiecare funcționalitate este un fișier
Fiecare fișier adaugă o funcționalitate. Fără configurare și fără cod de înregistrare.
Bloc de aplicație
blockstudio/
└── my-app/
├── block.json Definiția blocului
├── index.php Șablon + Interactivity API
├── style.css Stiluri delimitate
├── script-inline.js Logică pe client
├── db.php Model de date + CRUD
├── rpc.php Funcții pentru server
├── cron.php Sarcini programate
└── db/default.sqlite
Bază de date
Definiți scheme și obțineți puncte finale CRUD.
6 moduri de stocare
table, sqlite, jsonc, storh, meta, post_type. Alegeți în funcție de portabilitate și nevoile de interogare.
Fișiere Storh
Un fișier pentru fiecare înregistrare în uploads, cu indexuri construite din schemă și scrieri concurente mai sigure. wp bs db migrate –to=storh mută JSONC înregistrări și le păstrează ID-urile.
Tabele și tipuri de articole
Stocarea în tabele gestionează un tabel MySQL cu dbDelta și adaugă coloane pentru câmpurile noi. Stocarea post_type transformă fiecare înregistrare într-un articol, astfel încât WP_Query, pluginurile REST API și instrumentele GraphQL să o poată citi.
Mai multe scheme
Returnați scheme denumite dintr-un singur db.php. Fiecare are propria stocare, propriile endpointuri și propriul control al accesului.
Date asociate utilizatorului
Setați userScoped pentru a izola automat înregistrările, fără filtrare manuală.
Validare și hook-uri
Tipuri, valori obligatorii, enumerări, formate, lungimi, funcții callback și hook-uri pentru ciclul de viață.
RPC
Funcții de server apelabile din interfața frontend.
Client bs.fn()
Apelați funcții din JavaScript; scripturile inline detectează automat numele blocului.
Controlul accesului
Public cu CSRF, deschis pentru webhook-uri sau bazat pe capabilități, pentru fiecare funcție.
Apeluri între blocuri
Apelați orice funcție de bloc din JavaScript sau PHP și compuneți logica.
Stratul de date pentru client
Citiți, memorați în cache și scrieți înregistrări din browser.
clientul bs.db()
Creați, listați, obțineți, actualizați și ștergeți înregistrări din JavaScript. list acceptă filtre pentru câmpuri, limită și offset.
bs.query()
Preluări memorate în cache după cheie. Apelurile în curs partajează aceeași promisiune, iar staleTime omite cererea cât timp datele sunt actualizate.
bs.mutate()
Creare, actualizare și ștergere optimiste într-o matrice de stare reactivă, revenind la un instantaneu dacă cererea eșuează.
bs.cache
Cache-ul din memorie din spatele bs.query() și bs.mutate(). Citiți, setați, invalidați sau ștergeți direct intrările.
Interogare periodică în timp real
Activați timpul real în db.php, iar clientul compară periodic un hash al datelor, apoi actualizează stocarea Interactivity API. Interogarea periodică se oprește în filele ascunse.
Pagini memorate în cache
bs.fn() și bs.db() preiau acreditări actualizate de la un endpoint care nu este memorat în cache la primul apel, astfel încât apelurile publice să funcționeze în continuare pe paginile servite din cache-uri cu durată lungă.
Formulare și ecrane de aplicație
Formulare randate din schemă și UI incluse pentru a construi aplicații.
Formulare bazate pe schemă
Atribuiți unui câmp o cheie de componentă, iar bs_db_form() randează formularul prin acele blocuri, transmițând fiecăruia definiția câmpului.
Formular inclus
Cu ui.enabled, bsui/form block=”…” trimite câmpurile la endpointul de creare al blocului, afișează fiecare eroare de validare sub câmpul corespunzător și declanșează formsuccess sau formerror.
Aplicații exemplu
Setarea ui înregistrează și exemplele app/*, precum app/kitchen-sink și app/chat, construite cu aceleași componente bsui.
Infrastructură
Cron, CLI, cod de configurare și portabilitate.
Sarcini programate
Sarcinile cron.php se înregistrează în WP-Cron. Dezinstalările Composer le elimină cu wp bs teardown.
CLI pentru baza de date
wp bs db listează înregistrări cu filtre pentru câmpuri, le obține, creează, actualizează și șterge, apoi afișează tabele, JSON sau CSV.
Testați din terminal
wp bs rpc call rulează o funcție cu parametri –key=value, iar wp bs cron run execută imediat o sarcină, indiferent de programarea ei.
Fișiere de inițializare
init.php și alte fișiere init*.php dintr-un dosar de bloc rulează o dată la init, pentru configurări precum înregistrarea unui tip de articol.
Definiții native pentru PHP
rpc.php și cron.php pot returna o clasă cu metode #[Rpc] și #[Cron] și enumerările Access, Method și Schedule. db.php poate folosi Schema::make() și constructori Field.
Portabilitate
SQLite și JSONC călătoresc împreună cu codul: copiați un folder pentru a implementa aplicația.
Kitul oficial de extensii
Șabloane premium de site, instrucțiuni de sistem pentru AI și o comunitate privată Discord. Achiziție unică, actualizări pe viață.
- 500+ șabloane de site
- Instrucțiuni de sistem pentru IA
- Actualizări pe viață
- Comunitate privată Discord