Bloki za celoten sklad
Zbirka podatkov, strežniške funkcije, cron in CLI v eni mapi.
db.php
Določite shemo, dobite končne točke 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
Funkcije strežnika po meri
<?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];
},
];Vsaka zmožnost je datoteka
Vsaka datoteka doda eno zmožnost. Brez konfiguracije in registracijske kode.
Aplikacijski blok
blockstudio/
└── my-app/
├── block.json Definicija bloka
├── index.php Predloga + Interactivity API
├── style.css Omejeni slogi
├── script-inline.js Logika odjemalca
├── db.php Podatkovni model + CRUD
├── rpc.php Funkcije strežnika
├── cron.php Načrtovana opravila
└── db/default.sqlite
Podatkovna zbirka
Določite sheme in pridobite končne točke CRUD.
6 načinov shranjevanja
table, sqlite, jsonc, storh, meta, post_type. Izberite glede na prenosljivost in potrebe po poizvedbah.
Datoteke Storh
Ena datoteka na zapis v uploads, z indeksi, ustvarjenimi iz sheme, in varnejšimi sočasnimi zapisi. wp bs db migrate –to=storh prenese JSONC zapisov in ohrani njihove ID-je.
Tabele in tipi objav
Shramba table upravlja tabelo MySQL z dbDelta in doda stolpce za nova polja. Shramba post_type vsak zapis shrani kot objavo, zato ga lahko berejo WP_Query, vtičniki REST API in orodja GraphQL.
Več shem
Iz enega db.php vrnite poimenovane sheme. Vsaka dobi svojo shrambo, končne točke in nadzor dostopa.
Podatki, omejeni na uporabnika
Nastavite userScoped za samodejno ločevanje zapisov brez ročnega filtriranja.
Preverjanje in kljuke
Vrste, zahtevane vrednosti, naštevanja, formati, dolžine, povratni klici in kljuke življenjskega cikla.
RPC
Strežniške funkcije, ki jih je mogoče klicati iz vmesnika.
Odjemalec bs.fn()
Kličite funkcije iz JavaScript; vgrajeni skripti samodejno zaznajo ime bloka.
Nadzor dostopa
Javno z zaščito CSRF, odprto za spletne kljuke ali na podlagi zmožnosti, za vsako funkcijo posebej.
Klici med bloki
Kličite katero koli funkcijo bloka iz JavaScript ali PHP in sestavljajte logiko.
Podatkovni sloj odjemalca
Berite, predpomnite in zapisujte zapise v brskalniku.
odjemalec bs.db()
Ustvarjajte, naštevajte, pridobivajte, posodabljajte in brišite zapise iz JavaScript. list sprejema filtre polj, omejitev in odmik.
bs.query()
Klici fetch, predpomnjeni po ključu. Klici v teku si delijo isto obljubo, staleTime pa preskoči zahtevo, dokler so podatki sveži.
bs.mutate()
Optimistično ustvarjanje, posodabljanje in brisanje v reaktivni matriki stanja; ob neuspešni zahtevi se stanje povrne na posnetek.
bs.cache
Pomnilniški predpomnilnik za bs.query() in bs.mutate(). Vnose lahko neposredno berete, nastavljate, razveljavljate ali počistite.
Periodično preverjanje v realnem času
Nastavite realni čas v db.php; odjemalec nato v intervalih primerja zgoščeno vrednost podatkov in posodablja shrambo Interactivity API. Preverjanje se v skritih zavihkih začasno ustavi.
Predpomnjene strani
bs.fn() in bs.db() ob prvem klicu pridobita sveže poverilnice iz končne točke, ki ni predpomnjena, zato javni klici še naprej delujejo na straneh, ki jih streže dolgotrajni predpomnilnik.
Obrazci in zasloni aplikacij
Obrazci, izrisani iz sheme, in priloženi UI za gradnjo.
Obrazci sheme
Polju dodelite ključ komponente in bs_db_form() izriše obrazec prek teh blokov ter vsakemu posreduje definicijo polja.
Združeni obrazec
Z ui.enabled bsui/form block=”…” pošlje svoja polja končni točki za ustvarjanje tega bloka, pod vsakim poljem prikaže napake preverjanja in sproži formssuccess ali formerror.
Primeri aplikacij
Nastavitev ui registrira tudi primere app/*, kot sta app/kitchen-sink in app/chat, ki so zgrajeni iz istih komponent bsui.
Infrastruktura
Cron, CLI, nastavitvena koda in prenosljivost.
Načrtovana opravila
Opravila cron.php se registrirajo z WP-Cron. Composer jih odstrani ob odstranitvi z ukazom wp bs teardown.
Podatkovna baza CLI
wp bs db našteva zapise s filtri polj ter jih pridobiva, ustvarja, posodablja in briše; izpiše tabele, JSON ali CSV.
Preizkusite v terminalu
wp bs rpc call zažene funkcijo s parametri –key=value, wp bs cron run pa takoj sproži opravilo ne glede na njegov urnik.
Inicializacijske datoteke
init.php in druge datoteke init*.php v mapi bloka se enkrat zaženejo ob init, na primer za registracijo tipa objave.
Definicije, prilagojene PHP
rpc.php in cron.php lahko vrneta razred z metodama #[Rpc] in #[Cron] ter naštevalnimi tipi Access, Method in Schedule. db.php lahko uporablja gradnike Schema::make() in Field.
Prenosljivost
SQLite in JSONC potujeta skupaj s kodo: za uvedbo aplikacije kopirajte eno mapo.
Uradni komplet razširitev
Vrhunske predloge spletnih mest, sistemska navodila za UI in zasebna skupnost Discord. Enkratni nakup, posodobitve za vedno.
- Več kot 500+ predlog spletnih mest
- Sistemska navodila za UI
- Doživljenjske posodobitve
- Zasebna skupnost Discord