Täisvirna plokid
Andmebaas, serverifunktsioonid, cron ja CLI ühes kaustas.
db.php
Määratle skeem ja loo CRUD-lõpp-punktid
<?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
Kohandatud serverifunktsioonid
<?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];
},
];Iga võimalus on fail
Iga fail lisab ühe võimaluse. Seadistust ega registreerimiskoodi pole vaja.
Rakenduse plokk
blockstudio/
└── my-app/
├── block.json Ploki määratlus
├── index.php Mall + Interactivity API
├── style.css Piiritletud stiilid
├── script-inline.js Kliendipoolne loogika
├── db.php Andmemudel + CRUD
├── rpc.php Serverifunktsioonid
├── cron.php Ajastatud ülesanded
└── db/default.sqlite
Andmebaas
Määra skeemid, loo CRUD-lõpp-punktid.
6 salvestusrežiimi
table, sqlite, jsonc, storh, meta, post_type. Vali teisaldatavuse ja päringuvajaduste järgi.
Storh faili
Iga kirje jaoks salvestatakse kausta uploads eraldi fail, indeksid luuakse skeemi põhjal ja samaaegsed kirjutamised on turvalisemad. wp bs db migrate –to=storh teisaldab JSONC kirjet ja säilitab nende ID-d.
Tabelid ja postitüübid
Tabelisalvestus haldab tabelit MySQL käsuga dbDelta ja lisab uute väljade jaoks veerud. post_type-salvestus teeb igast kirjest postituse, mida saavad lugeda WP_Query, REST API pluginad ja GraphQL tööriistad.
Mitu skeemi
Tagasta ühest db.php-st nimega skeemid. Igal neist on oma salvestus, otspunktid ja juurdepääsu kontroll.
Kasutajapõhiselt piiritletud andmed
Määra userScoped, et kirjed eraldataks automaatselt, ilma käsitsi filtreerimata.
Valideerimine ja hook’id
Tüübid, kohustuslikud väärtused, loendid, vormingud, pikkused, tagasihelistused ja elutsükli hook’id.
RPC
Serverifunktsioonid, mida saab kasutajaliidesest välja kutsuda.
bs.fn() klient
Kutsu funktsioone välja JavaScript-ist; skriptid tuvastavad ploki nime automaatselt.
Juurdepääsu kontroll
Avalik koos CSRF-iga, webhook’ide jaoks avatud või funktsioonipõhine õigustega piiratud.
Plokkidevahelised kutsed
Kutsu mis tahes ploki funktsiooni JavaScript-ist või PHP-st ja pane loogika kokku.
Kliendi andmekiht
Lugege, salvestage vahemällu ja kirjutage kirjeid brauserist.
bs.db() klient
Looge, loendage, hankige, uuendage ja kustutage kirjeid asukohast JavaScript. list võtab vastu väljade filtrid, limiidi ja nihke.
bs.query()
Võtmepõhised vahemällu salvestatud päringud. Käimasolevad kutsed jagavad üht lubadust ning staleTime jätab päringu vahele, kuni andmed on värsked.
bs.mutate()
Kirjete optimistlik loomine, uuendamine ja kustutamine reaktiivses olekumassiivis; päringu nurjumisel taastatakse hetktõmmis.
bs.cache
Mälusisene vahemälu bs.query() ja bs.mutate() taga. Lugege kirjeid otse, määrake neid, muutke kehtetuks või tühjendage.
Reaalajas küsitlus
Seadistage reaalajas värskendamine kohas db.php. Klient võrdleb kindla intervalliga andmete räsi ja uuendab seejärel Interactivity API salvestit. Peidetud vahekaartidel küsitlus peatub.
Vahemällu salvestatud lehed
bs.fn() ja bs.db() hangivad esimesel kutsel vahemällu salvestamata otspunktist värsked mandaadid, et avalikud kutsed töötaksid edasi ka kaua vahemällu salvestatud lehtedel.
Vormid ja rakenduse vaated
Skeemi põhjal renderdatud vormid ja komplektis olevad UI, millele edasi ehitada.
Skeemivormid
Määrake väljale komponendi võti ja bs_db_form() renderdab vormi nende plokkide kaudu, andes igale plokile selle välja määratluse.
Komplektvorm
ui.enabled korral saadab bsui/form block=”…” oma väljad selle ploki loomise otspunkti, kuvab iga valideerimisvea vastava välja all ning saadab sündmuse formsuccess või formerror.
Näidisrakendused
Seadistus ui registreerib ka näited app/*, näiteks app/kitchen-sink ja app/chat, mis on loodud samadest bsui komponentidest.
Taristu
Cron, CLI, seadistuskood ja teisaldatavus.
Ajastatud ülesanded
cron.php tööd registreeritakse WP-Cron-is. Composer eemaldab need installimisel käsuga wp bs teardown.
Andmebaasi CLI
wp bs db loetleb kirjeid väljade filtrite abil, hangib, loob, uuendab ja kustutab neid ning prindib tabelid, JSON või CSV.
Testige terminalist
wp bs rpc call käivitab funktsiooni parameetritega –key=value ning wp bs cron run käivitab töö kohe, olenemata selle ajakavast.
Init-failid
init.php ja muud plokikausta init*.php failid käivitatakse init-i ajal üks kord. Nii saab näiteks registreerida postitüübi.
PHP-põhised määratlused
rpc.php ja cron.php võivad tagastada klassi, milles on #[Rpc] ja #[Cron] meetodid ning Access, Method ja Schedule loendid. db.php saab kasutada Schema::make() ja Fieldi koostajaid.
Teisaldatavus
SQLite ja JSONC liiguvad koos koodiga: kopeeri rakenduse juurutamiseks üks kaust.
Ametlik laienduskomplekt
Esmaklassilised saidimallid, tehisintellekti süsteemijuhised ja privaatne Discord kogukond. Ühekordne ost, eluaegsed uuendused.
- 500+ saidimalli
- Tehisintellekti süsteemijuhised
- Eluaegsed uuendused
- Privaatne Discord-i kogukond