Pilna steka bloki
Datubāze, servera funkcijas, cron un CLI vienā mapē.
db.php
Definējiet shēmu, iegūstiet CRUD galapunktus
<?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
Pielāgotas servera funkcijas
<?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];
},
];Katra iespēja ir fails
Katrs fails pievieno vienu iespēju. Bez konfigurācijas un reģistrācijas koda.
Lietotnes bloks
blockstudio/
└── my-app/
├── block.json Bloka definīcija
├── index.php Veidne + Interactivity API
├── style.css Lokāli tvērtie stili
├── script-inline.js Klienta loģika
├── db.php Datu modelis + CRUD
├── rpc.php Servera funkcijas
├── cron.php Ieplānotie uzdevumi
└── db/default.sqlite
Datu bāze
Definējiet shēmas un iegūstiet CRUD galapunktus.
6 glabāšanas režīmi
table, sqlite, jsonc, storh, meta, post_type. Izvēlieties pēc pārnesamības un vaicājumu vajadzībām.
Storh faili
Katrs ieraksts tiek glabāts atsevišķā failā mapē uploads, indeksus veidojot no shēmas, un vienlaicīga rakstīšana ir drošāka. wp bs db migrate –to=storh pārvieto JSONC ierakstus un saglabā to ID.
Tabulas un ierakstu tipi
Tabulu krātuve pārvalda MySQL tabulu, izmantojot dbDelta, un pievieno kolonnas jauniem laukiem. post_type krātuve katru ierakstu veido kā ziņu, ko var nolasīt WP_Query, REST API spraudņi un GraphQL rīki.
Vairākas shēmas
Atgrieziet nosauktas shēmas no viena db.php. Katrai ir sava krātuve, galapunkti un piekļuves kontrole.
Lietotājam piesaistīti dati
Iestatiet userScoped, lai ieraksti tiktu automātiski nodalīti bez manuālas filtrēšanas.
Validācija un āķi
Datu tipi, obligātās vērtības, uzskaitījumi, formāti, garumi, atzvanīšanas funkcijas un dzīves cikla āķi.
RPC
Servera funkcijas, ko var izsaukt no priekšgala.
bs.fn() klients
Izsauciet funkcijas no JavaScript; iegultie skripti automātiski nosaka bloka nosaukumu.
Piekļuves kontrole
Publiski pieejams ar CSRF aizsardzību, atvērts tīmekļa āķiem vai balstīts uz iespējām — katrai funkcijai atsevišķi.
Izsaukumi starp blokiem
Izsauciet jebkuru bloka funkciju no JavaScript vai PHP un apvienojiet loģiku.
Klienta datu slānis
Lasiet, kešojiet un rakstiet ierakstus pārlūkprogrammā.
bs.db() klients
Izveidojiet, uzskaitiet, iegūstiet, atjauniniet un dzēsiet ierakstus, izmantojot JavaScript. list pieņem lauku filtrus, limit un offset.
bs.query()
Kešoti pieprasījumi pēc atslēgas. Vienlaikus izpildāmie izsaukumi koplieto vienu solījumu, bet staleTime izlaiž pieprasījumu, kamēr dati ir aktuāli.
bs.mutate()
Optimistiska ierakstu izveide, atjaunināšana un dzēšana reaktīvā stāvokļa masīvā; ja pieprasījums neizdodas, dati tiek atjaunoti no momentuzņēmuma.
bs.cache
Atmiņā glabātais kešatmiņas slānis aiz bs.query() un bs.mutate(). Tieši lasiet, iestatiet, anulējiet vai notīriet ierakstus.
Reāllaika aptauja
Iestatiet reāllaika režīmu sadaļā db.php, un klients regulāri salīdzina datu jaucējvērtību, pēc tam atjauninot Interactivity API krātuvi. Slēptās cilnēs aptauja tiek apturēta.
Kešotas lapas
bs.fn() un bs.db() pirmajā izsaukumā no keša neizmantota galapunkta iegūst jaunas akreditācijas datus, tāpēc publiskie izsaukumi turpina darboties lapās, kas tiek rādītas no ilgstošas kešatmiņas.
Veidlapas un lietotņu ekrāni
Veidlapas tiek renderētas no shēmas, un komplektā iekļautais UI ir gatavs turpmākai izstrādei.
Shēmas veidlapas
Piešķiriet laukam komponenta atslēgu, un bs_db_form() renderēs veidlapu, izmantojot šos blokus, katram nododot tā lauka definīciju.
Komplektēta veidlapa
Izmantojot ui.enabled, bsui/form block=”…” nosūta savus laukus uz šī bloka create galapunktu, parāda katru validācijas kļūdu zem attiecīgā lauka un izsūta form success vai formerror notikumu.
Lietotņu piemēri
Iestatījums ui arī reģistrē app/* piemērus, piemēram, app/kitchen-sink un app/chat, kas veidoti no tiem pašiem bsui komponentiem.
Infrastruktūra
Cron, CLI, iestatīšanas kods un pārnesamība.
Ieplānotie uzdevumi
cron.php uzdevumi tiek reģistrēti WP-Cron. Composer instalēšanas noņemšana tos dzēš ar wp bs teardown.
Datubāzes CLI
wp bs db uzskaita ierakstus ar lauku filtriem, tos iegūst, izveido, atjaunina un dzēš, kā arī izvada tabulas, JSON vai CSV.
Testēšana terminālī
wp bs rpc call izpilda funkciju ar –key=value parametriem, bet wp bs cron run tūlīt palaiž darbu neatkarīgi no tā grafika.
Inicializācijas faili
init.php un citi init*.php faili bloka mapē tiek izpildīti vienreiz, inicializācijas laikā, lai veiktu tādus iestatīšanas darbus kā ieraksta tipa reģistrēšana.
PHP vietējās definīcijas
rpc.php un cron.php var atgriezt klasi ar #[Rpc] un #[Cron] metodēm, kā arī Access, Method un Schedule uzskaitījumiem. db.php var izmantot Schema::make() un Field veidotājus.
Pārnesamība
SQLite un JSONC tiek pārvietoti kopā ar kodu: nokopējiet vienu mapi, lai izvietotu lietotni.
Oficiālais paplašinājumu komplekts
Premium vietņu veidnes, AI sistēmas instrukcijas un privāta Discord kopiena. Vienreizējs pirkums, atjauninājumi uz mūžu.
- 500+ vietņu veidnes
- AI sistēmas instrukcijas
- Atjauninājumi visā lietošanas laikā
- Privāta Discord kopiena