Ugrás a tartalomhoz

Adminisztráció

A Blockstudio adminisztrációs felülete a Tools > Blockstudio menüpont alatt található. A projekt szintjén betekintést nyújt abba, hogy a Blockstudio mit regisztrált a fájlrendszerből, és lehetővé teszi a regiszterek és az adatbázisrekordok böngészését.

Ez szándékosan nem beállítási oldal. A cél az átláthatóság: láthatóvá tenni, hogy jelenleg milyen blokkok, bővítmények, mezők, oldalak, sémák, regiszterek és adatbázisrekordok léteznek.

Hozzáférés

Az adminisztrációs oldal akkor érhető el, ha mindkét feltétel teljesül:

  • az aktuális felhasználó rendelkezik a manage_options jogosultsággal
  • az oldal engedélyezve van a blockstudio/admin/enabled segítségével

A teljes letiltáshoz használja ezt:

PHP
add_filter('blockstudio/admin/enabled', '__return_false');

Nézetek

Áttekintés

Az áttekintés a Blockstudio regisztrációinak csak olvasható leltára. Külön lapokon jeleníti meg a következőket:

  • Blokkok: regisztrált blokktípusok, renderelési mód, API verzió, attribútumok száma
  • Bővítmények: célok, prioritás, renderelési mód, attribútumok száma
  • Mezők: újrafelhasználható field.json definíciók
  • Oldalak: fájlalapú oldalak a bejegyzéstípussal, állapottal, motorral és szinkronizálási állapottal
  • Sémák: regisztrált db.php sémák a tárolási móddal és a mezők számával

A táblázatok a natív WordPress DataViews nézetet használják, így a felület a wp-adminhoz igazodik, és nem vezet be külön kezelőfelületet.

Regiszter

Ha a projektben a blocks.json konfigurált regisztereket tartalmaz, az adminisztrációs oldalon megjelenik egy Regiszter nézet. Lekéri az ezekben a regiszterekben elérhető blokkokat, és lehetővé teszi közvetlen importálásukat a beállított blokkkönyvtárba.

A blocks.json ugyanazon konfigurációja működteti a CLI parancsot és az adminisztrációs böngészőt:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blocks.json",
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json"
  }
}

A hitelesített regiszterek támogatottak az headers és ${ENV_VAR} behelyettesítését használó objektumformátummal. A teljes konfigurációs formátumért lásd a Regiszter dokumentációját.

Adatbázisok

Ha a projekt bármilyen db.php sémát regisztrál, az adminisztrációs oldalon megjelenik egy Adatbázisok nézet. Minden séma külön lapot kap, amelyen a tényleges rekordok DataViews-táblázatban láthatók.

A felület nem szerializálja az összes rekordot az adminisztrációs oldal kezdeti adatcsomagjába. Ehelyett:

  1. a séma metaadatai előre betöltődnek
  2. a rekordok igény szerint töltődnek be az adatbázislap megnyitásakor
  3. a táblázatok lapozva jelenítik meg a REST API tartalmát

Így az adminisztrációs felület nagyobb adathalmazok esetén is használható marad.

Hatókör

A jelenlegi hatókör szándékosan szűk:

  • megvizsgálhatja, mit regisztrált a Blockstudio
  • blokkokat importálhat a beállított regiszterekből
  • adatbázisrekordokat böngészhet

Nem váltja fel a meglévő beállítási munkafolyamatot, és nem teszi lehetővé a blokk- vagy oldaldefiníciók közvetlen szerkesztését.