Vai al contenuto

Informazioni generali

Il Registry Blockstudio è uno strumento CLI per distribuire e installare blocchi WordPress da registri ospitati.

Funziona come shadcn/ui, ma per i blocchi WordPress. Non serve installare alcun pacchetto npm. Eseguite un comando, il codice sorgente del blocco viene copiato nel vostro progetto e ne avete il pieno controllo.

Come funziona

  1. Gli autori dei blocchi pubblicano un registry.json su un URL, elencando i blocchi disponibili.
  2. Aggiungete un blocks.json al vostro tema o plugin, indicando i registri che volete usare.
  3. Eseguite npx blockstudio add ui/tabs e la cartella del blocco verrà inserita nel vostro progetto.

Tutto qui. Il CLI scarica i file, risolve le dipendenze e li scrive su disco. Non trasforma nulla. Una cartella di blocco WordPress è uguale ovunque.

Cosa supporta

Il registro non dipende dal tipo di blocco: copia le cartelle. Funziona qualsiasi blocco che si trovi in una directory:

  • Blocchi Blockstudio: block.json + template PHP/Twig/Blade + risorse facoltative
  • Blocchi @wordpress/create-block: output di build completo JS con edit.js, save.js e così via
  • Blocchi PHP semplici: qualsiasi blocco registrato con register_block_type()
  • Blocchi statici: blocchi con solo un block.json e senza rendering lato server

Al CLI non interessa cosa contiene la cartella. Legge il manifest dei file dal registro e scarica esattamente i file elencati.

Amministrazione WordPress

Se il tema attivo ha un blocks.json con registri configurati, gli stessi registri compaiono anche in Strumenti > Blockstudio > Registry all’interno di wp-admin.

Questo browser di amministrazione consente di esaminare i blocchi disponibili e importarli senza modificare il CLI. Il formato di configurazione rimane lo stesso. blocks.json continua a essere la fonte ufficiale.

Avvio rapido

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Per la configurazione completa, consultate Introduzione.