Ylläpito
Blockstudio sisältää ylläpitonäkymän kohdassa Tools > Blockstudio. Se on projektitason tarkastelunäkymä, josta näkee, mitä Blockstudio on rekisteröinyt tiedostojärjestelmästä. Lisäksi sen avulla voi selata rekistereitä ja tietokantatietueita.
Tämä ei tarkoituksella ole asetussivu. Tavoitteena on näkyvyys: mitä lohkoja, laajennuksia, kenttiä, sivuja, skeemoja, rekistereitä ja tietokantatietueita on tällä hetkellä olemassa.
Käyttöoikeus
Ylläpitosivu on käytettävissä, kun molemmat seuraavista ehdoista täyttyvät:
- nykyisellä käyttäjällä on käyttöoikeus
manage_options - sivu on otettu käyttöön asetuksella
blockstudio/admin/enabled
Poista se kokonaan käytöstä seuraavasti:
add_filter('blockstudio/admin/enabled', '__return_false');
Näkymät
Yleiskatsaus
Yleiskatsaus on vain luku -muotoinen luettelo Blockstudio-rekisteröinneistä. Siinä on omat välilehdet seuraaville:
- Lohkot: rekisteröidyt lohkotyypit, renderöintitila, API-versio, ominaisuuksien määrä
- Laajennukset: kohteet, prioriteetti, renderöintitila, ominaisuuksien määrä
- Kentät: uudelleenkäytettävät
field.json-määritykset - Sivut: tiedostopohjaiset sivut, joiden tiedot sisältävät sisältötyypin, tilan, moottorin ja synkronointitilan
- Skeemat: rekisteröidyt
db.php-skeemat tallennustavan ja kenttien määrineen
Taulukoissa käytetään WordPressin natiiveja WordPress-DataViews-näkymiä, jotta ruutu pysyy wp-adminin linjan mukaisena eikä käyttöliittymää tarvitse keksiä uudelleen.
Rekisteri
Jos projektissasi on blocks.json, jossa on määritettyjä rekistereitä, ylläpitosivulla näkyy Rekisteri-näkymä. Se hakee rekistereistä saatavilla olevat lohkot ja antaa tuoda ne suoraan määritettyyn lohkohakemistoon.
Sama blocks.json-määritys ohjaa sekä CLI-toimintoa että ylläpidon selainta:
{
"$schema": "https://blockstudio.dev/schema/blocks.json",
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json"
}
}
Tunnistautumista edellyttäviä rekistereitä tuetaan objektimuodon kautta käyttämällä arvojen headers ja ${ENV_VAR} interpolointia. Katso täydellinen määritysmuoto kohdasta Rekisterin ohjeet.
Tietokannat
Jos projektissasi rekisteröidään db.php-skeemoja, ylläpitosivulla näkyy Tietokannat-näkymä. Jokaisella skeemalla on oma välilehtensä, jolla sen todelliset tietueet näytetään DataViews-taulukossa.
Ruutu ei sarjallista kaikkia tietueita ylläpidon alkuperäiseen tietosisältöön. Sen sijaan:
- skeemojen metatiedot alustetaan käännöksen yhteydessä
- tietueet haetaan tarvittaessa, kun avaat tietokannan välilehden
- taulukot jakavat REST API sivuille
Näin ylläpitoruutu pysyy käyttökelpoisena myös silloin, kun projektissa on suuria tietojoukkoja.
Rajaus
Nykyinen rajaus on tarkoituksella suppea:
- tarkastella, mitä Blockstudio on rekisteröinyt
- tuoda lohkoja määritetyistä rekistereistä
- selata tietokantatietueita
Se ei korvaa nykyistä asetustyönkulkua eikä muokkaa suoraan lohkojen tai sivujen määrityksiä.