
# Administration

Blockstudio inclut un écran d’administration sous **Outils > Blockstudio**. Il s’agit d’un espace d’inspection à l’échelle du projet qui montre ce que Blockstudio a enregistré depuis le système de fichiers, ainsi que d’un navigateur de registres et d’enregistrements de la base de données.

Il ne s’agit volontairement pas d’une page de réglages. L’objectif est de voir ce qui existe actuellement : blocs, extensions, champs, pages, schémas, registres et enregistrements de la base de données.

## Accès

La page d’administration est accessible lorsque ces deux conditions sont réunies :

- l’utilisateur actuel possède la capacité `manage_options`
- la page est activée via `blockstudio/admin/enabled`

Désactivez-la complètement avec :

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

## Vues

### Vue d’ensemble

La vue d’ensemble est un inventaire en lecture seule des enregistrements de Blockstudio. Elle comprend des onglets dédiés à :

- **Blocs** : types de blocs enregistrés, mode de rendu, version de API, nombre d’attributs
- **Extensions** : cibles, priorité, mode de rendu, nombre d’attributs
- **Champs** : définitions réutilisables de `field.json`
- **Pages** : pages basées sur des fichiers avec type de contenu, état, moteur et état de synchronisation
- **Schémas** : schémas `db.php` enregistrés, avec le stockage et le nombre de champs

Les tableaux utilisent les DataViews natifs de WordPress afin que l’écran reste cohérent avec wp-admin, sans créer une interface distincte.

### Registre

Si votre projet possède un `blocks.json` avec des registres configurés, la page d’administration affiche une vue **Registre**. Elle récupère les blocs disponibles dans ces registres et vous permet de les importer directement dans le répertoire de blocs configuré.

La même configuration `blocks.json` alimente à la fois CLI et le navigateur d’administration :

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

Les registres authentifiés sont pris en charge via le format objet avec l’interpolation de `headers` et `${ENV_VAR}`. Consultez la [documentation des registres](https://blockstudio.dev/fr/registry/) pour connaître le format de configuration complet.

### Bases de données

Si votre projet enregistre des schémas `db.php`, la page d’administration affiche une vue **Bases de données**. Chaque schéma possède son propre onglet, qui présente les enregistrements réels dans un tableau DataViews.

L’écran ne sérialise pas tous les enregistrements dans la charge utile initiale de l’administration. À la place :

1. les métadonnées du schéma sont localisées à l’avance
2. les enregistrements sont récupérés à la demande lorsque vous ouvrez un onglet de base de données
3. les tableaux parcourent les REST API par pagination

Ainsi, l’écran d’administration reste utilisable même lorsque le projet contient de grands ensembles de données.

## Périmètre

Le périmètre actuel est volontairement restreint :

- inspecter ce que Blockstudio a enregistré
- importer des blocs depuis les registres configurés
- parcourir les enregistrements de la base de données

Cela ne remplace pas le processus de réglages existant et ne permet pas de modifier directement les définitions de blocs ou de pages.
