Aller au contenu

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
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
{
  "$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 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.