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
- Les auteurs de blocs publient un
registry.jsonsur un URL qui répertorie les blocs disponibles. - Vous ajoutez un
blocks.jsonà votre thème ou extension, pointant vers les registres que vous souhaitez utiliser. - Vous exécutez
npx blockstudio add ui/tabset 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 avecedit.js,save.js, etc. - Blocs PHP simples : tout bloc enregistré avec
register_block_type() - Blocs statiques : blocs contenant uniquement un
block.jsonet 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
npx blockstudio init
npx blockstudio add ui/tabs
Consultez Bien démarrer pour découvrir la configuration complète.