Täyden pinon lohkot
Tietokanta, palvelinfunktiot, cron ja CLI yhdessä kansiossa.
db.php
Määritä skeema, saat CRUD-päätepisteet
<?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
Mukautetut palvelintoiminnot
<?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];
},
];Jokainen ominaisuus on tiedosto
Jokainen tiedosto lisää yhden ominaisuuden. Ei asetuksia eikä rekisteröintikoodia.
Sovelluslohko
blockstudio/
└── my-app/
├── block.json Lohkon määritys
├── index.php Malli + Interactivity API
├── style.css Rajatut tyylit
├── script-inline.js Asiakaspuolen logiikka
├── db.php Tietomalli + CRUD
├── rpc.php Palvelintoiminnot
├── cron.php Ajoitetut tehtävät
└── db/default.sqlite
Tietokanta
Määritä skeemat, saat CRUD-rajapinnat.
6 tallennustilaa
table, sqlite, jsonc, storh, meta, post_type. Valitse siirrettävyyden ja kyselytarpeiden mukaan.
Storh-tiedostot
Yksi tiedosto tietuetta kohti uploads-kansiossa, skeeman perusteella luodut indeksit ja turvallisemmat samanaikaiset kirjoitukset. wp bs db migrate –to=storh siirtää JSONC tietuetta ja säilyttää niiden tunnukset.
Taulut ja sisältötyypit
Taulutallennus hallinnoi MySQL-taulua dbDeltalla ja lisää sarakkeet uusille kentille. post_type-tallennus tekee kustakin tietueesta artikkelin, joten WP_Query, REST API -lisäosat ja GraphQL -työkalut voivat lukea sitä.
Useita skeemoja
Palauta nimetyt skeemat yhdestä db.php-kohteesta. Jokaisella on oma tallennustila, päätepisteet ja käyttöoikeuksien hallinta.
Käyttäjäkohtainen data
Aseta userScoped eristämään tietueet automaattisesti ilman manuaalista suodatusta.
Validointi ja koukut
Tyypit, pakolliset arvot, luetellut arvot, muodot, pituudet, takaisinkutsut ja elinkaarikoukut.
RPC
Palvelinfunktiot, joita voi kutsua käyttöliittymästä.
bs.fn()-asiakas
Kutsu funktioita JavaScript-ratkaisusta; rivinsisäiset skriptit tunnistavat lohkon nimen automaattisesti.
Käyttöoikeuksien hallinta
Julkinen CSRF-suojauksella, avoin webhookeille tai funktiokohtainen kyvykkyyspohjainen käyttöoikeus.
Lohkojen väliset kutsut
Kutsu mitä tahansa lohkofunktiota JavaScript- tai PHP-ratkaisusta ja yhdistele logiikkaa.
Asiakkaan datakerros
Lue, tallenna välimuistiin ja kirjoita tietueita selaimesta.
bs.db()-asiakas
Luo, luettele, hae, päivitä ja poista tietueita kohteesta JavaScript. list hyväksyy kenttäsuodattimet, rajan ja siirtymän.
bs.query()
Välimuistiin tallennetut haut avaimen perusteella. Käynnissä olevat kutsut jakavat saman lupauksen, ja staleTime ohittaa pyynnön, kun data on ajan tasalla.
bs.mutate()
Luo, päivitä ja poista tietueita optimistisesti reaktiivisessa tilataulukossa; epäonnistunut pyyntö palauttaa tilanteen tilannekuvan mukaiseksi.
bs.cache
Kohteiden bs.query() ja bs.mutate() taustalla oleva muistivälimuisti. Lue, aseta, mitätöi tai tyhjennä merkintöjä suoraan.
Reaaliaikainen kysely
Aseta reaaliaikaisuus kohteessa db.php. Asiakas vertaa datatiivistettä aikavälein ja päivittää sitten Interactivity API -tilan. Kysely keskeytyy piilotetuilla välilehdillä.
Välimuistiin tallennetut sivut
bs.fn() ja bs.db() hakevat tuoreet tunnistetiedot välimuistittamattomasta päätepisteestä ensimmäisellä kutsulla, joten julkiset kutsut toimivat edelleen sivuilla, joita tarjotaan pitkään voimassa olevista välimuisteista.
Lomakkeet ja sovellusnäkymät
Skeemasta muodostetut lomakkeet ja sovelluksen rakentamiseen tarkoitetut valmiit UI-komponentit.
Skeemalomakkeet
Anna kentälle komponenttiavain, niin bs_db_form() muodostaa lomakkeen näiden lohkojen avulla ja välittää kullekin sen kenttämäärittelyn.
Sisäänrakennettu lomake
Kun käytössä on ui.enabled, bsui/form block=”…” lähettää kenttänsä kyseisen lohkon luontipäätepisteeseen, näyttää kunkin validointivirheen kentän alla ja käynnistää tapahtuman formsuccess tai formerror.
Esimerkkisovellukset
ui-asetus rekisteröi myös app/*-esimerkit, kuten app/kitchen-sink ja app/chat, jotka on rakennettu samoista bsui-komponenteista.
Infrastruktuuri
Cron, CLI, asetuskoodi ja siirrettävyys.
Ajoitetut tehtävät
cron.php-työt rekisteröidään WP-Cron-ratkaisuun. Composer-asennusten poistaminen poistaa ne komennolla wp bs teardown.
Tietokannan CLI
wp bs db luettelee tietueet kenttäsuodattimien avulla, hakee niitä sekä luo, päivittää ja poistaa niitä. Se tulostaa tauluja, JSON tai CSV.
Testaa päätteessä
wp bs rpc call suorittaa funktion –key=value-parametreilla, ja wp bs cron run käynnistää työn heti sen aikataulusta riippumatta.
Alustustiedostot
init.php ja muut lohkokansion init*.php-tiedostot suoritetaan kerran init-vaiheessa esimerkiksi sisältötyypin rekisteröintiä varten.
PHP-natiivimäärittelyt
rpc.php ja cron.php voivat palauttaa luokan, jossa on #[Rpc]- ja #[Cron]-metodit sekä Access-, Method- ja Schedule-enumit. db.php voi käyttää Schema::make()- ja Field-rakentajia.
Siirrettävyys
SQLite ja JSONC kulkevat koodin mukana: kopioi yksi kansio ottaaksesi sovelluksen käyttöön.
Virallinen laajennuspaketti
Premium-sivupohjia, tekoälyn järjestelmäohjeita ja yksityinen Discord-yhteisö. Kertamaksu, elinikäiset päivitykset.
- 500+ sivustomallia
- Tekoälyn järjestelmäohjeet
- Elinikäiset päivitykset
- Yksityinen Discord-yhteisö