Preskočiť na obsah

Administrácia

Blockstudio obsahuje administračnú obrazovku v ponuke Nástroje > Blockstudio. Ide o projektové rozhranie na kontrolu toho, čo Blockstudio zaregistroval zo súborového systému, a tiež na prehliadanie registrov a záznamov databázy.

Zámerne nejde o stránku nastavení. Cieľom je prehľad o tom, ktoré bloky, rozšírenia, polia, stránky, schémy, registre a záznamy databázy práve existujú.

Prístup

Stránka administrácie je dostupná, ak sú splnené obe tieto podmienky:

  • aktuálny používateľ má oprávnenie manage_options
  • stránka je povolená prostredníctvom blockstudio/admin/enabled

Úplne ju vypnete takto:

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

Zobrazenia

Prehľad

Prehľad je inventár registrácií Blockstudio určený iba na čítanie. Obsahuje samostatné karty pre:

  • Bloky: registrované typy blokov, režim vykresľovania, verzia API, počet atribútov
  • Rozšírenia: ciele, priorita, režim vykresľovania, počet atribútov
  • Polia: opakovane použiteľné definície field.json
  • Stránky: stránky založené na súboroch s typom príspevku, stavom, enginom a stavom synchronizácie
  • Schémy: registrované schémy db.php s počtom úložísk a polí

Tabuľky používajú natívne DataViews WordPress, aby obrazovka zostala v súlade s wp-admin namiesto vytvárania samostatného rozhrania.

Register

Ak váš projekt obsahuje blocks.json s nakonfigurovanými registrami, stránka administrácie zobrazí pohľad Register. Načíta dostupné bloky z týchto registrov a umožní ich importovať priamo do nakonfigurovaného adresára blokov.

Tá istá konfigurácia blocks.json slúži pre CLI aj prehliadač administrácie:

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

Registrované registre podporujú autentifikáciu prostredníctvom formátu objektu s interpoláciou headers a ${ENV_VAR}. Úplný formát konfigurácie nájdete v dokumentácii Registra.

Databázy

Ak váš projekt registruje nejaké schémy db.php, stránka administrácie zobrazí pohľad Databázy. Každá schéma dostane vlastnú kartu a zobrazuje skutočné záznamy v tabuľke DataViews.

Obrazovka neserializuje všetky záznamy do úvodného administračného obsahu. Namiesto toho:

  1. metadáta schém sa lokalizujú vopred
  2. záznamy sa načítajú podľa potreby po otvorení karty databázy
  3. tabuľky stránkujú cez REST API

Vďaka tomu zostáva obrazovka administrácie použiteľná aj v projektoch s väčšími súbormi údajov.

Rozsah

Aktuálny rozsah je zámerne úzky:

  • kontrolovať, čo Blockstudio zaregistroval
  • importovať bloky z nakonfigurovaných registrov
  • prehliadať záznamy databázy

Nenahrádza existujúci postup nastavení a priamo neupravuje definície blokov ani stránok.