Siirry sisältöön

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:

PHP
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:

JSON
{
  "$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:

  1. skeemojen metatiedot alustetaan käännöksen yhteydessä
  2. tietueet haetaan tarvittaessa, kun avaat tietokannan välilehden
  3. 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ä.