Aller au contenu

Généralités

Le registre Blockstudio est un outil CLI permettant de distribuer et d’installer des blocs WordPress depuis des registres hébergés.

Il fonctionne comme shadcn/ui, mais pour les blocs WordPress. Aucun paquet npm n’est à installer. Vous exécutez une commande, le code source du bloc est copié dans votre projet, et vous en avez la pleine propriété.

Fonctionnement

  1. Les auteurs de blocs publient un registry.json sur un URL qui répertorie les blocs disponibles.
  2. Vous ajoutez un blocks.json à votre thème ou extension, pointant vers les registres que vous souhaitez utiliser.
  3. Vous exécutez npx blockstudio add ui/tabs et le dossier du bloc est ajouté à votre projet.

C’est tout. Le CLI télécharge les fichiers, résout les dépendances et les écrit sur le disque. Il ne transforme rien. Un dossier de bloc WordPress est identique partout.

Éléments pris en charge

Le registre est indépendant du type de bloc. Il copie des dossiers. Tout bloc stocké dans un répertoire fonctionne :

  • Blocs Blockstudio : block.json + modèle PHP/Twig/Blade + ressources facultatives
  • Blocs @wordpress/create-block : sortie de compilation complète JS avec edit.js, save.js, etc.
  • Blocs PHP simples : tout bloc enregistré avec register_block_type()
  • Blocs statiques : blocs contenant uniquement un block.json et aucun rendu côté serveur

Le CLI ne se soucie pas du contenu du dossier. Il lit le manifeste des fichiers du registre et télécharge exactement ces fichiers.

Administration WordPress

Si le thème actif dispose d’un blocks.json configuré avec des registres, ceux-ci apparaissent aussi dans Outils > Blockstudio > Registre dans wp-admin.

Cette interface d’administration permet d’examiner les blocs disponibles et de les importer sans toucher au CLI. Le format de configuration reste le même. blocks.json demeure la référence.

Démarrage rapide

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Consultez Bien démarrer pour découvrir la configuration complète.