Pular para o conteúdo

Geral

O Registry Blockstudio é uma ferramenta CLI para distribuir e instalar blocos WordPress de registros hospedados.

Funciona como shadcn/ui, mas para blocos WordPress. Não há nenhum pacote npm para instalar. Você executa um comando, o código-fonte do bloco é copiado para o seu projeto e ele passa a ser totalmente seu.

Como funciona

  1. Os autores de blocos publicam um registry.json em um URL que lista os blocos disponíveis.
  2. Você adiciona um blocks.json ao seu tema ou plugin, apontando para os registros que quer usar.
  3. Você executa npx blockstudio add ui/tabs e a pasta do bloco é adicionada ao seu projeto.

É só isso. O CLI baixa os arquivos, resolve as dependências e os grava no disco. Ele não transforma nada. Uma pasta de bloco WordPress é igual em todos os lugares.

O que é compatível

O registro é independente do tipo de bloco. Ele copia pastas. Qualquer bloco que esteja em um diretório funciona:

  • Blocos Blockstudio: block.json + modelo PHP/Twig/Blade + recursos opcionais
  • Blocos @wordpress/create-block: saída completa de build JS com edit.js, save.js etc.
  • Blocos PHP simples: qualquer bloco registrado com register_block_type()
  • Blocos estáticos: blocos com apenas um block.json e sem renderização no lado do servidor

O CLI não se importa com o conteúdo da pasta. Ele lê o manifesto de arquivos do registro e baixa exatamente esses arquivos.

Admin WordPress

Se o tema ativo tiver um blocks.json com registros configurados, os mesmos registros também aparecerão em Ferramentas > Blockstudio > Registry no wp-admin.

Esse navegador de administração permite inspecionar os blocos disponíveis e importá-los sem tocar no CLI. O formato de configuração continua igual. blocks.json permanece como fonte oficial.

Início rápido

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Consulte Primeiros passos para ver a configuração completa.