Bloky s kompletným zásobníkom
Databáza, funkcie servera, cron a CLI v jednom priečinku.
db.php
Definujte schému a získajte koncové body 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
Vlastné funkcie servera
<?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];
},
];Každá schopnosť je súbor
Každý súbor pridáva jednu schopnosť. Bez konfigurácie a registračného kódu.
Aplikačný blok
blockstudio/
└── my-app/
├── block.json Definícia bloku
├── index.php Šablóna + Interactivity API
├── style.css Štýly s obmedzeným rozsahom
├── script-inline.js Logika na strane klienta
├── db.php Dátový model + CRUD
├── rpc.php Funkcie servera
├── cron.php Naplánované úlohy
└── db/default.sqlite
Databáza
Definujte schémy a získajte koncové body CRUD.
6 režimov ukladania
table, sqlite, jsonc, storh, meta, post_type. Vyberte si podľa prenositeľnosti a potrieb pri dotazovaní.
Súbory Storh
Jeden súbor na záznam v priečinku uploads, indexy vytvorené podľa schémy a bezpečnejšie súbežné zápisy. Príkaz wp bs db migrate –to=storh presunie záznamy JSONC a zachová ich ID.
Tabuľky a typy príspevkov
Ukladanie do tabuľky spravuje tabuľku MySQL pomocou dbDelta a pridáva stĺpce pre nové polia. Pri ukladaní do post_type sa každý záznam vytvorí ako príspevok, takže ho môžu čítať WP_Query, doplnky REST API aj nástroje GraphQL.
Viacero schém
Vráťte pomenované schémy z jedného db.php. Každá má vlastné úložisko, koncové body a riadenie prístupu.
Údaje v rozsahu používateľa
Nastavením userScoped automaticky izolujete záznamy bez potreby manuálneho filtrovania.
Validácia a háky
Typy, povinné hodnoty, výčty, formáty, dĺžky, spätné volania a háky životného cyklu.
RPC
Funkcie servera volateľné z frontendu.
klient bs.fn()
Volajte funkcie z JavaScript; vložené skripty automaticky rozpoznajú názov bloku.
Riadenie prístupu
Verejný s CSRF, otvorený pre webhooky alebo založený na oprávneniach – pre každú funkciu zvlášť.
Volania medzi blokmi
Volajte ľubovoľnú funkciu bloku z JavaScript alebo PHP a skladajte logiku.
Dátová vrstva klienta
Čítajte, ukladajte do vyrovnávacej pamäte a zapisujte záznamy z prehliadača.
Klient bs.db()
Vytvárajte, vypisujte, získavajte, aktualizujte a odstraňujte záznamy z JavaScript. Funkcia list prijíma filtre polí, limit a posun.
bs.query()
Načítania z vyrovnávacej pamäte podľa kľúča. Prebiehajúce volania zdieľajú jednu promise a staleTime preskočí požiadavku, kým sú údaje aktuálne.
bs.mutate()
Optimistické vytváranie, aktualizovanie a odstraňovanie v poli reaktívneho stavu; pri zlyhaní požiadavky sa stav obnoví zo snímky.
bs.cache
Pamäťová vyrovnávacia pamäť pre bs.query() a bs.mutate(). Záznamy môžete priamo čítať, nastavovať, zneplatňovať alebo vymazávať.
Pravidelné načítanie v reálnom čase
Nastavte režim v reálnom čase v db.php. Klient v pravidelných intervaloch porovnáva hash údajov a potom aktualizuje úložisko Interactivity API. Načítanie sa pozastaví na skrytých kartách.
Stránky uložené vo vyrovnávacej pamäti
bs.fn() a bs.db() pri prvom volaní načítajú aktuálne prihlasovacie údaje z koncového bodu mimo vyrovnávacej pamäte, takže verejné volania fungujú aj na stránkach poskytovaných z dlhodobej vyrovnávacej pamäte.
Formuláre a obrazovky aplikácie
Formuláre vykreslené podľa schémy a pribalené UI, na ktorých môžete stavať.
Formuláre podľa schémy
Priraďte poľu kľúč komponentu a bs_db_form() vykreslí formulár pomocou týchto blokov a každému odovzdá definíciu poľa.
Zabalený formulár
Pomocou ui.enabled odošle bsui/form block=”…” svoje polia koncovému bodu create daného bloku, zobrazí každú chybu validácie pod príslušným poľom a vyvolá form success alebo formerror.
Ukážkové aplikácie
Nastavenie ui tiež registruje ukážky app/*, napríklad app/kitchen-sink a app/chat, vytvorené z rovnakých komponentov bsui.
Infraštruktúra
Cron, CLI, nastavovací kód a prenositeľnosť.
Naplánované úlohy
Úlohy cron.php sa registrujú pomocou WP-Cron. Odinštalovanie Composer ich odstráni príkazom wp bs teardown.
Databáza CLI
wp bs db vypisuje záznamy s filtrami polí, získava ich, vytvára, aktualizuje a odstraňuje a zobrazuje tabuľky, JSON alebo CSV.
Testovanie z terminálu
wp bs rpc call spustí funkciu s parametrami –key=value a wp bs cron run spustí úlohu okamžite bez ohľadu na jej plán.
Inicializačné súbory
init.php a ostatné súbory init*.php v priečinku bloku sa spustia raz pri init, napríklad na registráciu typu príspevku.
Definície natívne pre PHP
rpc.php a cron.php môžu vrátiť triedu s metódami #[Rpc] a #[Cron] a výpočtovými typmi Access, Method a Schedule. db.php môže používať Schema::make() a nástroje na tvorbu polí.
Prenositeľnosť
SQLite a JSONC sa prenášajú spolu s kódom: na nasadenie aplikácie stačí skopírovať jeden priečinok.
Oficiálna súprava rozšírení
Prémiové šablóny webov, systémové pokyny pre AI a súkromná komunita Discord. Jednorazový nákup, aktualizácie na celý život.
- 500+ šablón stránok
- Systémové pokyny pre AI
- Doživotné aktualizácie
- Súkromná komunita Discord