Teljes veremű blokkok
Adatbázis, szerverfüggvények, cron és CLI egyetlen mappában.
db.php
Határozd meg a sémát, és megkapod a CRUD-végpontokat
<?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
Egyéni szerverfunkciók
<?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];
},
];Minden képesség egy fájl
Minden fájl egy képességet ad hozzá. Nincs szükség konfigurációra vagy regisztrációs kódra.
Alkalmazásblokk
blockstudio/
└── my-app/
├── block.json Blokkdefiníció
├── index.php Sablon + Interactivity API
├── style.css Hatókörre korlátozott stílusok
├── script-inline.js Kliensoldali logika
├── db.php Adatmodell + CRUD
├── rpc.php Szerverfunkciók
├── cron.php Ütemezett feladatok
└── db/default.sqlite
Adatbázis
Sémák definiálása, CRUD-végpontok létrehozása.
6 tárolási mód
table, sqlite, jsonc, storh, meta, post_type. Válassz hordozhatóság és lekérdezési igények szerint.
Storh fájl
Rekordonként egy fájl az uploads alatt, a sémából felépített indexekkel és biztonságosabb párhuzamos írásokkal. A wp bs db migrate –to=storh áthelyezi a JSONC rekordokat, és megőrzi az azonosítóikat.
Táblák és bejegyzéstípusok
A táblás tárolás egy MySQL táblát kezel a dbDelta használatával, és oszlopokat ad hozzá az új mezőkhöz. A post_type tárolás minden rekordot bejegyzésként hoz létre, így a WP_Query, a REST API bővítmények és a GraphQL eszközök is olvashatják.
Több séma
Adjon vissza névvel ellátott sémákat egyetlen db.php-ból. Mindegyik saját tárolót, végpontokat és hozzáférés-szabályozást kap.
Felhasználóhoz kötött adatok
Állítsd be a userScoped értéket a rekordok automatikus elkülönítéséhez, kézi szűrés nélkül.
Validálás és hookok
Típusok, kötelező értékek, felsorolások, formátumok, hosszok, visszahívások és életciklus-hookok.
RPC
A frontendről hívható szerverfüggvények.
bs.fn() kliens
Hívj függvényeket a JavaScript-ből; a beágyazott szkriptek automatikusan felismerik a blokk nevét.
Hozzáférés-vezérlés
Függvényenként beállítható: nyilvános, CSRF-védelemmel; webhookokhoz nyitott; vagy képességalapú.
Blokkok közötti hívások
Bármelyik blokkfüggvény meghívása a JavaScript vagy a PHP felől, és a logika összeállítása.
Ügyféloldali adatréteg
Rekordok olvasása, gyorsítótárazása és írása a böngészőből.
bs.db() kliens
Rekordok létrehozása, listázása, lekérése, frissítése és törlése innen: JavaScript. A list mezőszűrőket, limitet és eltolást fogad.
bs.query()
Kulcs szerinti, gyorsítótárazott lekérések. A folyamatban lévő hívások egyetlen ígéretet osztanak meg, a staleTime pedig kihagyja a kérést, amíg frissek az adatok.
bs.mutate()
Optimista létrehozás, frissítés és törlés egy reaktív állapottömbön; sikertelen kérés esetén az állapot visszaáll egy pillanatképre.
bs.cache
A bs.query() és bs.mutate() mögötti memóriabeli gyorsítótár. A bejegyzések közvetlenül olvashatók, beállíthatók, érvényteleníthetők vagy törölhetők.
Valós idejű lekérdezés
Állítsa be a valós idejű működést a db.php fájlban; az ügyféloldali kód ezután időközönként összehasonlítja az adatlenyomatot, majd frissíti az Interactivity API áruházat. A lekérdezés rejtett lapokon szünetel.
Gyorsítótárazott oldalak
A bs.fn() és a bs.db() az első híváskor egy gyorsítótárazatlan végpontról friss hitelesítő adatokat kér le, így a nyilvános hívások továbbra is működnek a hosszú élettartamú gyorsítótárból kiszolgált oldalakon.
Űrlapok és alkalmazásképernyők
A sémából megjelenített űrlapok és a hozzájuk tartozó UI komponensek.
Sémaalapú űrlapok
Adjon egy komponenskulcsot a mezőnek, és a bs_db_form() ezeken a blokkokon keresztül jeleníti meg az űrlapot, mindegyiknek átadva a mező definícióját.
Összevont űrlap
A ui.enabled használatakor a bsui/form block=”…” elküldi a mezőit az adott blokk létrehozási végpontjára, minden érvényesítési hibát a hozzá tartozó mező alatt jelenít meg, majd formuccess vagy formerror eseményt vált ki.
Példaalkalmazások
A ui beállítás az app/* példákat is regisztrálja, például az app/kitchen-sink és az app/chat alkalmazást, amelyek ugyanazokból a bsui komponensekből épülnek fel.
Infrastruktúra
Cron, CLI, beállító kód és hordozhatóság.
Ütemezett feladatok
A cron.php feladatok a WP-Cron segítségével regisztrálódnak. A Composer-telepítések a wp bs teardown paranccsal eltávolítják őket.
Adatbázis-CLI
A wp bs db mezőszűrőkkel listázza a rekordokat, lekéri, létrehozza, frissíti és törli őket, valamint táblázatokat, JSON-t vagy CSV-t ír ki.
Tesztelés a terminálból
A wp bs rpc call függvényt futtat a –key=value paraméterekkel, a wp bs cron run pedig az ütemezéstől függetlenül azonnal elindít egy feladatot.
Inicializáló fájlok
A init.php és a blokk mappájában található további init*.php fájlok egyszer futnak le az init során; például bejegyzéstípus regisztrálására használhatók.
PHP-natív definíciók
A rpc.php és a cron.php visszaadhat egy osztályt #[Rpc] és #[Cron] metódusokkal, valamint az Access, Method és Schedule felsorolásokkal. A db.php használhatja a Schema::make() elemet és a Field építőket.
Hordozhatóság
A SQLite és a JSONC a kóddal együtt utazik: az alkalmazás telepítéséhez elég egyetlen mappát átmásolni.
A hivatalos bővítőkészlet
Prémium webhelysablonok, MI-rendszerutasítások és privát Discord közösség. Egyszeri vásárlás, élethosszig tartó frissítések.
- 500+ webhelysablon
- AI-rendszerutasítások
- Élettartamra szóló frissítések
- Privát Discord közösség