
# Administravimas

Blockstudio turi administravimo ekraną, pasiekiamą per **Tools > Blockstudio**. Tai projekto lygmens tikrinimo vieta, kurioje matoma, ką Blockstudio užregistravo iš failų sistemos, taip pat galima naršyti registrus ir duomenų bazės įrašus.

Tai sąmoningai nėra nustatymų puslapis. Jo tikslas – parodyti, kokie blokai, plėtiniai, laukai, puslapiai, schemos, registrai ir duomenų bazės įrašai šiuo metu yra.

## Prieiga

Administravimo puslapis pasiekiamas, kai tenkinamos abi šios sąlygos:

- dabartinis naudotojas turi `manage_options` galimybę
- puslapis įjungtas per `blockstudio/admin/enabled`

Visiškai išjunkite naudodami:

```php title="functions.php"
add_filter('blockstudio/admin/enabled', '__return_false');
```

## Rodiniai

### Apžvalga

Apžvalgoje pateikiamas tik skaitymui skirtas Blockstudio registracijų sąrašas. Joje yra atskiri skirtukai:

- **Blokai**: registruoti blokų tipai, atvaizdavimo režimas, API versija, atributų skaičius
- **Plėtiniai**: paskirties vietos, prioritetas, atvaizdavimo režimas, atributų skaičius
- **Laukai**: pakartotinai naudojami `field.json` apibrėžimai
- **Puslapiai**: failais pagrįsti puslapiai su įrašo tipu, būsena, varikliu ir sinchronizavimo būsena
- **Schemos**: registruotos `db.php` schemos su saugyklos ir laukų skaičiumi

Lentelėse naudojami savieji WordPress DataViews, todėl ekranas dera su wp-admin, o ne kuria atskirą sąsają.

### Registras

Jei projekte yra `blocks.json` su sukonfigūruotais registrais, administravimo puslapyje rodomas **Registras** rodinys. Jis gauna iš šių registrų pasiekiamus blokus ir leidžia juos importuoti tiesiai į sukonfigūruotą blokų katalogą.

Ta pati `blocks.json` konfigūracija naudojama ir CLI, ir administravimo naršyklėje:

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

Autentifikuoti registrai palaikomi naudojant objekto formatą su `headers` ir `${ENV_VAR}` interpoliacija. Visą konfigūracijos formatą rasite [Registrų dokumentacijoje](https://blockstudio.dev/lt/registry/).

### Duomenų bazės

Jei projekte registruotos kokios nors `db.php` schemos, administravimo puslapyje rodomas **Duomenų bazės** rodinys. Kiekviena schema turi savo skirtuką, kuriame tikri įrašai pateikiami DataViews lentelėje.

Ekrane visi įrašai neserializuojami į pradinį administravimo duomenų paketą. Vietoj to:

1. schemų metaduomenys lokalizuojami iš anksto
2. įrašai gaunami pagal poreikį atidarius duomenų bazės skirtuką
3. lentelėse puslapiais pateikiami REST API

Taip administravimo ekranas išlieka patogus naudoti net ir tada, kai projekte yra didesnių duomenų rinkinių.

## Apimtis

Dabartinė apimtis sąmoningai siaura:

- tikrinti, ką užregistravo Blockstudio
- importuoti blokus iš sukonfigūruotų registrų
- naršyti duomenų bazės įrašus

Ši funkcija nepakeičia esamos nustatymų darbo eigos ir neleidžia tiesiogiai redaguoti blokų ar puslapių apibrėžimų.
