Dennis · 7 de fevereiro de 2026
Introducing Blockstudio 7
Blockstudio 7 chegou. Esta é a maior versão da história do projeto: uma reescrita completa, feita do zero, de toda a base de código. Todas as classes, todos os hooks, todas as linhas de código foram reconstruídos do início, com foco em PHP moderno, padrões de programação WordPress e facilidade de manutenção a longo prazo.
Mas não se trata apenas de uma refatoração. Blockstudio 7 traz grandes novidades, como páginas e padrões baseados em arquivos, um sistema de armazenamento de metadados de posts, integração com SEO e um novo analisador de HTML para blocos que dá suporte a tudo isso. Além disso, Blockstudio agora é totalmente gratuito e de código aberto.
Vamos conhecer todas as novidades.
Gratuito e de código aberto
Trabalho no Blockstudio desde 2020 e lancei dezenas de versões ao longo dos anos. Quem o usava gostava dele, mas encontrar espaço no mercado para um framework comercial de blocos de WordPress sempre foi um desafio.
O que mudou o cenário foram os LLMs. Os assistentes de programação com IA já são bons o suficiente para escrever código de blocos, mas precisam de estruturas organizadas e baseadas em arquivos. A marcação de blocos do WordPress é confusa: comentários serializados de HTML com atributos JSON incorporados, misturados à estrutura do DOM. Isso é difícil para as pessoas e ainda mais difícil para os LLMs acertarem.
A abordagem do Blockstudio, que prioriza arquivos, sempre foi pensada para manter tudo simples: um block.json e um modelo PHP em uma pasta. Sem entradas no banco de dados, sem React, sem etapa de compilação. Com o v7, essa filosofia vai ainda mais longe. O analisador de HTML para blocos permite escrever HTML simples e convertê-lo automaticamente em uma marcação de blocos válida. Tudo permanece no sistema de arquivos. As únicas gravações no banco de dados são sincronizações de páginas solicitadas explicitamente por meio do PHP API ou do CLI, e elas são orientadas por modelos de arquivos.
Tornar Blockstudio código aberto é o próximo passo natural. Quanto mais os LLMs treinam com código Blockstudio, melhor ficam em gerá-lo. Uma base de código aberta, documentação aberta e um arquivo de contexto para IA pré-criado que qualquer ferramenta pode usar: é assim que se constrói o melhor ambiente para desenvolvimento assistido por IA WordPress.
O plugin completo está disponível no GitHub para qualquer pessoa usar, bifurcar e contribuir. Sem chaves de licença, sem barreiras de pagamento, sem recursos bloqueados.
Novos recursos
Páginas baseadas em arquivos
Esta é uma das maiores novidades da versão 7.0. Agora você pode definir páginas inteiras do WordPress como modelos de arquivos que são sincronizados com o banco de dados como conteúdo de blocos nativos quando você executa o API ou o CLI de sincronização de páginas.
Crie uma pasta com um page.json e um arquivo de modelo:
{
"name": "about",
"title": "About Us",
"slug": "about",
"postStatus": "publish"
}
<div class="about-page">
<h1>About Us</h1>
<p>Welcome to our site.</p>
</div>
Execute wp bs pages sync para que Blockstudio analise o HTML em blocos WordPress e crie ou atualize a página no banco de dados.
Mesclagem de blocos por chave
Quando os modelos são sincronizados, as edições dos usuários normalmente seriam sobrescritas. O atributo key resolve isso preservando o conteúdo dos usuários entre as sincronizações:
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
Blocos com chaves correspondentes mantêm o conteúdo editado pelo usuário quando o modelo é atualizado. Blocos sem chaves são substituídos por completo.
Vinculações de blocos
Como alternativa às chaves, você pode usar as Block Bindings API nativas do núcleo do WordPress para conectar blocos diretamente aos metadados de posts. Esse recurso não é do Blockstudio; é uma funcionalidade nativa do WordPress API. O Blockstudio simplesmente transfere o atributo metadata para a marcação de blocos gerada. O conteúdo fica nos metadados, em vez de na marcação de blocos, então as sincronizações de modelos nunca apagam as edições dos usuários. Os dados também podem ser consultados via WP_Query e estão disponíveis pela REST API.
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
Default Title
</h1>
As duas abordagens podem ser usadas no mesmo modelo.
Controles de edição
As páginas aceitam blockEditingMode e templateLock para controlar o que os usuários podem modificar:
{
"name": "landing",
"title": "Landing Page",
"blockEditingMode": "contentOnly",
"templateLock": "all"
}
Isso bloqueia a estrutura da página e ainda permite que os usuários editem textos e mídias. Elementos individuais podem substituir a configuração da página com um atributo blockEditingMode no modelo.
Fixação a IDs de posts
Use postId para vincular um modelo de página a um post WordPress existente, evitando páginas duplicadas e garantindo que o modelo sempre atualize o post correto:
{
"name": "home",
"title": "Home",
"postId": 2
}
Para ver todos os detalhes, consulte a Documentação de páginas.
Padrões baseados em arquivos
Assim como nas páginas, agora você pode definir padrões de blocos como modelos de arquivos. Escreva seu padrão em HTML, e Blockstudio o converte em marcação de blocos e o registra como um padrão de blocos nativo do WordPress. Eles aparecem no inseridor de blocos e podem ser inseridos em qualquer lugar pelos usuários.
{
"name": "hero-section",
"title": "Hero Section",
"categories": ["featured"],
"keywords": ["hero", "banner"]
}
<div class="hero">
<h1>Welcome</h1>
<p>Get started today.</p>
</div>
Ao contrário das páginas, os padrões não criam entradas no banco de dados. Eles são registrados na memória a cada carregamento de página. Consulte a Documentação de padrões.
Analisador de HTML para blocos
Tanto as páginas quanto os padrões são processados por um novo analisador HTML, que converte modelos HTML padrão em marcação de blocos WordPress. Ele processa automaticamente blocos contêiner (como grupos e colunas) e blocos folha (como parágrafos e títulos). O analisador usa uma arquitetura de renderização baseada em traits, o que facilita a extensão com suporte a outros tipos de blocos por meio do filtro blockstudio/parser/renderers:
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
$renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
$content = $parser->get_inner_html( $element );
$html = '<div class="acme-hero">' . $content . '</div>';
return array(
'blockName' => 'acme/hero',
'attrs' => $attrs,
'innerBlocks' => array(),
'innerHTML' => $html,
'innerContent' => array( $html ),
);
};
return $renderers;
}, 10, 2 );
Depois de registrado, você pode usar o bloco em qualquer modelo de página ou padrão:
<block name="acme/hero" background="/hero.jpg">
<h1>Welcome to our site</h1>
</block>
Armazenamento
Agora os campos podem armazenar valores nos metadados de posts ou nas opções do site, além de nos atributos dos blocos. Esta é uma grande novidade:
{
"id": "subtitle",
"type": "text",
"label": "Subtitle",
"storage": {
"type": "postMeta"
}
}
Com valores nos metadados de posts, você pode:
- Consultar posts por valores de campos usando
WP_Queryemeta_query - Acessar dados de campos pela REST API em configurações headless
- Compartilhar dados com outros plugins, como ferramentas SEO e camadas de cache
Você também pode armazenar valores na tabela de opções para configurações globais do site:
{
"id": "phone",
"type": "text",
"label": "Phone Number",
"storage": {
"type": "option",
"optionKey": "company_phone"
}
}
Consulte a Documentação de armazenamento para ver o API completo.
Campos personalizados
Agora é possível compartilhar definições de campos reutilizáveis entre vários blocos. Defina um conjunto de campos uma única vez e depois referencie-o em qualquer bloco. Isso elimina a repetição quando vários blocos compartilham a mesma estrutura de campos.
Crie um field.json no diretório blockstudio:
{
"name": "hero",
"title": "Hero Section",
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
Depois, referencie-o em qualquer bloco usando o prefixo custom/:
{
"blockstudio": {
"attributes": [
{ "type": "custom/hero", "idStructure": "hero_{id}" }
]
}
}
A propriedade idStructure acrescenta um prefixo a cada ID de campo; assim, heading se torna hero_heading. Você também pode substituir propriedades de campos individuais por instância com a chave overrides.
Consulte a Documentação de campos personalizados.
Tailwind CSS v4
O suporte a Tailwind foi totalmente refeito para v4. Em vez de compilar no lado do cliente pelo CDN e salvar em disco ao salvar o post (a abordagem v6), o Blockstudio 7 compila Tailwind no lado do servidor a cada solicitação do frontend, via TailwindPHP. Sem Node.js, sem CLI, sem necessidade de etapa de compilação.
A compilação usa cache baseado em candidatos: Blockstudio extrai todos os nomes de classes CSS do HTML final, classifica e calcula um hash deles junto com sua configuração de CSS e verifica se há um arquivo em cache. As mesmas classes geram o mesmo resultado no cache, mesmo quando o HTML ao redor muda (nonces, marcas de tempo, conteúdo dinâmico).
A configuração usa a sintaxe com prioridade para CSS do Tailwind v4. Defina temas personalizados e classes utilitárias diretamente no seu blockstudio.json ou pelo filtro blockstudio/tailwind/css:
add_filter('blockstudio/tailwind/css', function ($css) {
return $css . '
@theme {
--color-brand: #4f46e5;
}
@layer utilities {
.container-narrow {
max-width: 48rem;
margin-inline: auto;
}
}
';
});
No editor de blocos, um script integrado de Tailwind CDN oferece uma prévia ao vivo enquanto você digita. O tipo de campo classes oferece preenchimento automático para todos os utilitários Tailwind. O frontend sempre usa o CSS compilado no servidor, inserido como uma tag de estilo inline antes de </head>.
Consulte a documentação de Tailwind para ver a configuração completa.
Interatividade API
Agora, Blockstudio oferece suporte à WordPress Interactivity API. Ative-a no seu block.json:
{
"blockstudio": {
"interactivity": true
}
}
Adicione diretivas data-wp-* ao seu modelo:
<div useBlockProps
data-wp-interactive="myBlock"
data-wp-context='{ "isOpen": false }'>
<button data-wp-on--click="actions.toggle"
data-wp-bind--aria-expanded="context.isOpen">
Toggle
</button>
<div data-wp-bind--hidden="!context.isOpen">
This content is toggled by the button.
</div>
</div>
E crie um script.js com a lógica do seu armazenamento:
import { store, getContext } from '@wordpress/interactivity';
store('myBlock', {
actions: {
toggle: () => {
const context = getContext();
context.isOpen = !context.isOpen;
},
},
});
Blockstudio gerencia o importmap, o carregamento de módulos e o processamento de diretivas tanto no frontend quanto no editor de blocos. Blocos que usam apenas diretivas declarativas com data-wp-context (como data-wp-bind--hidden ou data-wp-text) funcionam sem nenhum JavaScript. O estado do lado do servidor por meio de wp_interactivity_state() também é compatível no frontend.
Consulte a Documentação de interatividade para ver a configuração completa.
Análise de conteúdo com SEO
Os blocos Blockstudio são dinâmicos, então, por padrão, o conteúdo de seus campos fica invisível para os plugins SEO. O Blockstudio 7 corrige isso com integrações automáticas para Yoast SEO, Rank Math e SEOPress. Os valores de texto dos campos text, textarea, richtext, wysiwyg e link (incluindo linhas de repetidores aninhados) são extraídos e enviados para a análise de conteúdo de cada plugin. Agora, os plugins SEO podem analisar corretamente o conteúdo dos seus blocos quanto à densidade de palavras-chave, legibilidade e outras métricas. Não é necessária nenhuma configuração.
Linhas padrão do repetidor
Agora, os campos repetidores aceitam uma propriedade default com uma matriz de linhas pré-preenchidas. Quando um bloco é inserido, o repetidor é preenchido com as linhas e os valores especificados, tanto no editor quanto no frontend:
{
"id": "features",
"type": "repeater",
"label": "Features",
"default": [
{ "title": "Fast", "icon": "bolt" },
{ "title": "Secure", "icon": "shield" }
],
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "icon", "type": "text", "label": "Icon" }
]
}
A propriedade min também funciona com valores padrão no nível dos campos: se um repetidor tiver min: 3 e seus campos internos tiverem valores default, as linhas geradas automaticamente serão preenchidas com esses valores padrão em vez de ficarem vazias.
Melhorias e correções
mindo repetidor com valores padrão nos campos: agora as linhas mínimas geradas automaticamente usam os valores padrão definidos nos campos, tanto no frontend quanto no editor- Estilos do editor Tailwind: agora o Tailwind CSS compilado também é inserido no iframe do editor de blocos junto com o CDN, para que regras personalizadas de
@applye a configuração do tema funcionem no editor - Arquivo de contexto de IA: o
blockstudio-llm.txtfoi reconstruído como um arquivo estático, compilado a partir da documentação completa do v7 e de esquemas JSON sem duplicatas (~48k tokens), substituindo a geração dinâmica a partir de v6 - Janela pop-out do campo de código: agora é possível abrir o campo de código em uma janela separada, com ações independentes de desfazer/refazer e realce de sintaxe JavaScript
- Compilação no servidor de Tailwind v4: consulte acima a seção Tailwind
- Versão 3 de API: agora os blocos são renderizados corretamente no editor em iframe, incluindo o editor do site e as prévias responsivas
- Notação com ponto para recursos: convenção mais limpa para nomear arquivos e sufixos de recursos (
*.inline.css,*.editor.js,*.scoped.css) - Corrigido o aviso
bs_render_block()deWP_Block_Supportsao usaruseBlockProps - Corrigido o problema de campos condicionais que não respeitavam valores padrão no primeiro carregamento
- Corrigido o problema que removia cifrões do conteúdo
<RichText />no frontend - Corrigida a funcionalidade
populatepara funcionar com taxonomias registradas por outros plugins - Corrigido o erro nulo
optionsPopulateem contextos WPML
Por dentro
Reescrita completa
Não se trata de uma refatoração nem de uma limpeza. Todas as classes foram reescritas do zero. O resultado é uma base de código mais organizada e modular, fácil de manter e ampliar.
PHP moderno
Blockstudio 7 exige PHP 8.2+ e usa declarações de tipos modernas em todo o código.
Alterações incompatíveis
Como atualização de versão principal, a versão 7.0 inclui várias alterações incompatíveis. A maioria tem alternativas compatíveis com versões anteriores, mas você deve analisá-las antes de atualizar. Para ver o guia completo de migração, consulte a documentação de migração v7.
Os nomes dos hooks agora usam snake_case
Todos os hooks do PHP foram renomeados de camelCase para snake_case, seguindo as convenções do núcleo do WordPress:
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
return ['my-stylesheet'];
});
// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet'];
});
Os nomes antigos em camelCase ainda funcionam, mas recomendamos atualizá-los.
O padrão da chave de ativação agora é desativado
Agora, o padrão da propriedade switch é false, em vez de true. Na v6, todos os campos tinham um botão invisível na borda esquerda, ativado por padrão. Na v7, a chave é opcional e usa um ícone de olho visível no rótulo do campo. Se você dependia do comportamento padrão da chave, adicione "switch": true às definições dos seus campos.
Nomes de arquivos de recursos usam notação com ponto
Agora, os sufixos dos recursos usam pontos em vez de hífens (style.inline.css em vez de style-inline.css). A notação antiga com hífens ainda funciona, mas a notação com pontos é a convenção recomendada daqui em diante.
Prefixo de importação npm
Agora, as importações de módulos ES usam npm: em vez de blockstudio/:
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";
// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
O prefixo blockstudio/ ainda é compatível com versões anteriores.
Recursos removidos
Área administrativa e editor de código. A página de configurações administrativas do WordPress e o editor de código de blocos integrado foram removidos. Agora, toda a configuração é feita por meio dos filtros blockstudio.json e PHP, o que mantém sua configuração no controle de versão junto com seus blocos.
O editor de código era útil nas versões anteriores para visualizar blocos, mas nunca alcançou a paridade total com um ambiente de desenvolvimento real. Ao longo dos anos, vários recursos do plugin ficaram limitados porque não podiam ser compatíveis com o editor independente. Ele também nunca substituiria uma IDE completa. Removê-lo permite que o plugin se dedique inteiramente ao desenvolvimento baseado em arquivos, sem comprometer nada.
Chave de licença. Não é mais necessária. O Blockstudio é gratuito e de código aberto.
Biblioteca de blocos. A biblioteca integrada “Blockstudio Elements” (Galeria, Slider, Comparação de imagens, Código, Ícone) foi removida. Eram blocos de exemplo pré-criados, incluídos no plugin. Se você os usava, copie as pastas dos blocos de v6 para o diretório blockstudio do seu tema.
Primeiros passos
Instale o Blockstudio 7 e crie seu primeiro bloco em minutos. Confira o Guia de primeiros passos para ver um passo a passo, ou o guia de migração v7 se estiver atualizando do v6.
O código-fonte completo está no GitHub. Sugestões de problemas, PRs e feedback são bem-vindos.