Kompletní bloky
Databáze, serverové funkce, cron a CLI v jediné složce.
db.php
Definujte schéma a získejte CRUD endpointy
<?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í serverové funkce
<?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á schopnost je soubor
Každý soubor přidává jednu schopnost. Bez konfigurace a registračního kódu.
Aplikační blok
blockstudio/
└── my-app/
├── block.json Definice bloku
├── index.php Šablona + Interactivity API
├── style.css Izolované styly
├── script-inline.js Logika klienta
├── db.php Datový model + CRUD
├── rpc.php Serverové funkce
├── cron.php Naplánované úlohy
└── db/default.sqlite
Databáze
Definujte schémata a získejte koncové body CRUD.
6 režimů úložiště
table, sqlite, jsonc, storh, meta, post_type. Vyberte podle přenositelnosti a potřeb dotazování.
Storh soubory
Jeden soubor na záznam v uploads, s indexy vytvořenými podle schématu a bezpečnějším souběžným zápisem. Příkaz wp bs db migrate –to=storh převede JSONC záznamů a zachová jejich ID.
Tabulky a typy příspěvků
Ukládání do tabulky spravuje tabulku MySQL pomocí dbDelta a přidává sloupce pro nová pole. Ukládání do post_type vytváří z každého záznamu příspěvek, který mohou číst WP_Query, pluginy REST API a nástroje GraphQL.
Více schémat
Vraťte pojmenovaná schémata z jednoho db.php. Každé má vlastní úložiště, koncové body a řízení přístupu.
Data vymezená uživatelem
Nastavte userScoped a izolujte záznamy automaticky bez ručního filtrování.
Ověřování a hooky
Typy, povinné hodnoty, výčty, formáty, délky, zpětná volání a hooky životního cyklu.
RPC
Serverové funkce volatelné z frontendu.
Datová vrstva klienta
Čtěte, ukládejte do mezipaměti a zapisujte záznamy v prohlížeči.
Klient bs.db()
Vytvářejte, vypisujte, načítejte, aktualizujte a mažte záznamy z JavaScript. Funkce list přijímá filtry polí, limit a offset.
bs.query()
Načítání uložená v mezipaměti podle klíče. Probíhající volání sdílejí jeden příslib a staleTime přeskočí požadavek, dokud jsou data aktuální.
bs.mutate()
Optimistické vytváření, aktualizace a mazání v reaktivním poli stavu s obnovením snímku při selhání požadavku.
bs.cache
Mezipaměť v paměti pro bs.query() a bs.mutate(). Položky můžete přímo číst, nastavovat, zneplatňovat nebo mazat.
Průběžné dotazování
Nastavte realtime v db.php; klient v pravidelných intervalech porovnává hash dat a poté aktualizuje úložiště Interactivity API. Na skrytých kartách se dotazování pozastaví.
Stránky z mezipaměti
bs.fn() a bs.db() při prvním volání načtou aktuální přihlašovací údaje z koncového bodu bez mezipaměti, takže veřejná volání fungují i na stránkách poskytovaných z dlouhodobé mezipaměti.
Formuláře a obrazovky aplikací
Formuláře vykreslené ze schématu a připravené UI, na kterých lze stavět.
Formuláře podle schématu
Přiřaďte poli klíč komponenty a bs_db_form() vykreslí formulář prostřednictvím těchto bloků a každému předá definici pole.
Sdružený formulář
S ui.enabled odešle blok bsui/form block=”…” svá pole koncovému bodu pro vytváření daného bloku, zobrazí každou chybu ověření pod příslušným polem a vyvolá formsuccess nebo formerror.
Ukázkové aplikace
Nastavení ui také registruje příklady app/*, například app/kitchen-sink a app/chat, vytvořené ze stejných komponent bsui.
Infrastruktura
Cron, CLI, nastavovací kód a přenositelnost.
Naplánované úlohy
Úlohy cron.php se registrují přes WP-Cron. Při odinstalaci Composer se odstraní příkazem wp bs teardown.
Databázové CLI
wp bs db vypisuje záznamy s filtry polí, načítá je, vytváří, aktualizuje a maže a vypisuje tabulky, JSON nebo CSV.
Testování v terminálu
wp bs rpc call spustí funkci s parametry –key=value a wp bs cron run spustí úlohu ihned bez ohledu na její plán.
Inicializační soubory
init.php a další soubory init*.php ve složce bloku se jednou spustí při init, například pro registraci typu příspěvku.
Definice nativní pro PHP
rpc.php a cron.php mohou vracet třídu s metodami #[Rpc] a #[Cron] a výčty Access, Method a Schedule. db.php může používat Schema::make() a nástroje Field builder.
Přenositelnost
SQLite a JSONC putují spolu s kódem: aplikaci nasadíte zkopírováním jediné složky.
Oficiální sada rozšíření
Prémiové šablony webů, systémové pokyny pro umělou inteligenci a soukromá komunita Discord. Jednorázový nákup, doživotní aktualizace.
- 500+ šablon webů
- Systémové instrukce AI
- Doživotní aktualizace
- Soukromá komunita Discord