Full-stack-blokke
Database, serverfunktioner, cron og CLI i én mappe.
db.php
Definér et skema, få CRUD-endepunkter
<?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
Brugerdefinerede serverfunktioner
<?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];
},
];Hver funktion er en fil
Hver fil tilføjer én funktion. Ingen konfiguration eller registreringskode.
Applikationsblok
blockstudio/
└── my-app/
├── block.json Blokdefinition
├── index.php Skabelon + Interactivity API
├── style.css Afgrænsede typografier
├── script-inline.js Klientlogik
├── db.php Datamodel + CRUD
├── rpc.php Serverfunktioner
├── cron.php Planlagte opgaver
└── db/default.sqlite
Database
Definér skemaer, og få CRUD-endpoints.
6 lagringstilstande
table, sqlite, jsonc, storh, meta, post_type. Vælg ud fra portabilitet og forespørgselsbehov.
Storh-filer
Én fil pr. post under uploads med indekser opbygget ud fra skemaet og sikrere samtidige skrivninger. wp bs db migrate –to=storh flytter JSONC poster over og bevarer deres ID’er.
Tabeller og posttyper
Lagring i tabeller administrerer en MySQL-tabel med dbDelta og tilføjer kolonner til nye felter. Lagring i post_type gør hver post til et opslag, så WP_Query, REST API-plugins og GraphQL-værktøjer kan læse den.
Flere skemaer
Returnér navngivne skemaer fra én db.php. Hvert skema får sin egen lagring, sine endpoints og sin adgangskontrol.
Brugerafgrænsede data
Indstil userScoped for automatisk at isolere poster uden manuel filtrering.
Validering og hooks
Typer, påkrævede værdier, enums, formater, længder, callbacks og livscyklushooks.
RPC
Serverfunktioner, der kan kaldes fra frontend.
Datalag til klienten
Læs, cachelagr og skriv poster fra browseren.
bs.db()-klient
Opret, oplist, hent, opdatér og slet poster fra JavaScript. list tager feltfiltre, grænse og forskydning.
bs.query()
Cachelagrede hentninger efter nøgle. Kald, der er i gang, deler ét promise, og staleTime springer forespørgslen over, mens dataene er friske.
bs.mutate()
Optimistisk oprettelse, opdatering og sletning i et reaktivt tilstandsarray, som rulles tilbage til et snapshot, hvis forespørgslen mislykkes.
bs.cache
Hukommelsescachen bag bs.query() og bs.mutate(). Læs, angiv, ugyldiggør eller ryd poster direkte.
Polling i realtid
Slå realtid til i db.php, så sammenligner klienten et datahash med faste intervaller og opdaterer Interactivity API-lageret. Polling sættes på pause i skjulte faner.
Cachelagrede sider
bs.fn() og bs.db() henter friske legitimationsoplysninger fra et ikke-cachelagret endpoint ved første kald, så offentlige kald fortsat fungerer på sider, der leveres fra langtidscacher.
Formularer og appskærme
Formularer, der gengives ud fra skemaet, og medfølgende UI at bygge videre på.
Skemaformularer
Giv et felt en komponentnøgle, så gengiver bs_db_form() formularen gennem disse blokke og videregiver feltdefinitionen til hver af dem.
Samlet formular
Med ui.enabled sender bsui/form block=”…” sine felter til blokkens oprettelsesendpoint, viser hver valideringsfejl under det relevante felt og udsender formssuccess eller formerror.
Eksempelapps
Indstillingen ui registrerer også app/*-eksemplerne, såsom app/kitchen-sink og app/chat, som er bygget med de samme bsui-komponenter.
Infrastruktur
Cron, CLI, opsætningskode og portabilitet.
Planlagte opgaver
cron.php-jobs registreres i WP-Cron. Composer-installationer fjerner dem med wp bs teardown.
Database-CLI
wp bs db oplister poster med feltfiltre, henter, opretter, opdaterer og sletter dem samt udskriver tabeller, JSON eller CSV.
Test fra terminalen
wp bs rpc call kører en funktion med parametre af typen –key=value, og wp bs cron run kører et job med det samme, uanset dets tidsplan.
Init-filer
init.php og andre init*.php-filer i en blokmappe køres én gang ved init til opsætning, f.eks. registrering af en posttype.
PHP-native definitioner
rpc.php og cron.php kan returnere en klasse med #[Rpc]- og #[Cron]-metoder samt Access-, Method- og Schedule-enummeringerne. db.php kan bruge Schema::make() og feltbyggere.
Portabilitet
SQLite og JSONC følger med koden: kopiér én mappe for at udrulle appen.
Det officielle udvidelsessæt
Premiumskabeloner til websteder, AI-systeminstruktioner og et privat Discord-fællesskab. Engangskøb med opdateringer hele livet.
- 500+ hjemmesideskabeloner
- AI-systeminstruktioner
- Opdateringer hele livet
- Privat Discord-fællesskab