Fullstack-block
Databas, serverfunktioner, cron och CLI i en mapp.
db.php
Definiera ett schema och få CRUD-endpoints
<?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
Anpassade 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];
},
];Varje funktion är en fil
Varje fil lägger till en funktion. Ingen konfiguration och ingen registreringskod.
Applikationsblock
blockstudio/
└── my-app/
├── block.json Blockdefinition
├── index.php Mall + Interactivity API
├── style.css Avgränsade formatmallar
├── script-inline.js Klientlogik
├── db.php Datamodell + CRUD
├── rpc.php Serverfunktioner
├── cron.php Schemalagda uppgifter
└── db/default.sqlite
Databas
Definiera scheman och få CRUD-slutpunkter.
6 lagringslägen
table, sqlite, jsonc, storh, meta, post_type. Välj efter portabilitet och behov av frågor.
Storh filer
En fil per post under uploads, med index byggda från schemat och säkrare samtidiga skrivningar. wp bs db migrate –to=storh flyttar över JSONC poster och behåller deras ID:n.
Tabeller och inläggstyper
Tabellagring hanterar en tabell MySQL med dbDelta och lägger till kolumner för nya fält. Lagring med post_type gör varje post till ett inlägg, så att WP_Query, REST API-plugins och GraphQL-verktyg kan läsa det.
Flera scheman
Returnera namngivna scheman från en enda db.php. Varje schema får egen lagring, egna endpoints och egen åtkomstkontroll.
Användaravgränsade data
Ange userScoped för att isolera poster automatiskt, utan manuell filtrering.
Validering och hooks
Typer, obligatoriska värden, uppräkningar, format, längder, callbacks och livscykel-hooks.
RPC
Serverfunktioner som kan anropas från frontend.
Klientens datalager
Läs, cachelagra och skriv poster från webbläsaren.
bs.db()-klient
Skapa, lista, hämta, uppdatera och ta bort poster från JavaScript. list tar fältfilter, limit och offset.
bs.query()
Cachelagrade hämtningar efter nyckel. Pågående anrop delar ett och samma löfte, och staleTime hoppar över begäran medan data är aktuell.
bs.mutate()
Optimistisk skapning, uppdatering och borttagning i en reaktiv tillståndsarray, som återställs till en ögonblicksbild om begäran misslyckas.
bs.cache
Minnescachen bakom bs.query() och bs.mutate(). Läs, ange, ogiltigförklara eller rensa poster direkt.
Realtidsavläsning
Aktivera realtid i db.php så jämför klienten en datahash med jämna mellanrum och uppdaterar lagret för Interactivity API. Avläsningen pausas i dolda flikar.
Cachelagrade sidor
bs.fn() och bs.db() hämtar nya autentiseringsuppgifter från en ocachelagrad endpoint vid det första anropet, så offentliga anrop fortsätter att fungera på sidor som levereras från långlivade cacher.
Formulär och appskärmar
Formulär som renderas från schemat och medföljande UI att bygga vidare på.
Schemaformulär
Ange en komponentnyckel för ett fält, så renderar bs_db_form() formuläret med hjälp av dessa block och skickar varje block dess fältdefinition.
Inkluderat formulär
Med ui.enabled skickar bsui/form block=”…” sina fält till blockets create-endpoint, visar varje valideringsfel under motsvarande fält och skickar ut formens framgångs- eller felhändelse.
Exempelappar
ui-inställningen registrerar även app/*-exemplen, som app/kitchen-sink och app/chat, byggda med samma bsui-komponenter.
Infrastruktur
Cron, CLI, konfigurationskod och portabilitet.
Schemalagda uppgifter
cron.php-jobb registreras i WP-Cron. Vid avinstallation av Composer tas de bort med wp bs teardown.
Databas-CLI
wp bs db listar poster med fältfilter, hämtar, skapar, uppdaterar och tar bort dem samt skriver ut tabeller, JSON eller CSV.
Testa från terminalen
wp bs rpc call kör en funktion med parametrar av typen –key=value, och wp bs cron run kör ett jobb direkt, oavsett dess schema.
Initieringsfiler
init.php och andra init*.php-filer i en blockmapp körs en gång vid init, för konfiguration som att registrera en inläggstyp.
PHP-inbyggda definitioner
rpc.php och cron.php kan returnera en klass med metoderna #[Rpc] och #[Cron] samt enum-typerna Access, Method och Schedule. db.php kan använda Schema::make() och fältbyggare.
Portabilitet
SQLite och JSONC följer med koden: kopiera en mapp för att driftsätta appen.
Det officiella tilläggspaketet
Premiumwebbplatsmallar, systeminstruktioner för AI och en privat Discord-community. Engångsköp, uppdateringar på livstid.
- 500+ webbplatsmallar
- AI-systeminstruktioner
- Uppdateringar livet ut
- Privat Discord-community