Dennis · 14 de outubro de 2026
Blockstudio 7.7
Blockstudio A versão 7.7 adiciona rotas virtuais para documentos sem uma publicação WordPress, aprimora builds de pré-renderização direcionados e torna mais confiáveis a edição e a renderização de blocos existentes. Também amplia as verificações de tags de bloco de PHPStan e melhora a acessibilidade dos componentes UI incluídos.
O fluxo de trabalho baseado em arquivos continua igual. Os blocos são renderizados a partir de seus templates, e as páginas baseadas em arquivos são alteradas por meio de uma sincronização explícita de CLI ou API. Esta versão não introduz a sincronização automática de páginas em solicitações de visitantes ou de administração.
Em resumo:
- Rotas virtuais: disponibilize uma galeria de componentes, um catálogo ou outro documento completo sem criar uma publicação nem escrever um manipulador de redirecionamento personalizado.
- Builds de pré-renderização direcionados: builds de HTTP registram os arquivos de origem usados por cada página, para que um build posterior possa renderizar apenas as rotas afetadas.
- Retenção de cache: mantenha folhas de estilo desativadas disponíveis para páginas em cache e inspecione ou remova entradas não utilizadas do mapa de disponibilização antecipada.
- Confiabilidade do editor: blocos selecionados em conjunto mantêm seus próprios valores, desfazer e refazer funcionam para RichText e campos da barra lateral, e o contexto herdado permanece associado ao bloco correto.
- Fidelidade do conteúdo em arquivos: listas aninhadas, elementos de seção, HTML inline, shortcodes e atributos escapados sobrevivem à análise e à renderização.
- Melhorias em PHPStan: tags com prefixo, aliases, elementos de página mapeados e variáveis de template são verificados em relação às definições do próprio projeto.
- UI acessível: os controles expõem seu estado corretamente, os rótulos alternam o controle certo, e os componentes de lista e tabela usam uma estrutura HTML válida.
- Traduções: traduções instaladas de JavaScript são carregadas no editor e na visão geral de administração, incluindo controles de campo que antes não tinham tradução.
Rotas virtuais
Algumas páginas vêm de dados, e não de uma publicação controlada pelo editor. Uma referência de componente, por exemplo, pode precisar de seu próprio URL e título de documento, mas não de uma entrada em wp_posts.
Registre esse documento com Blockstudio\Virtual_Routes:
add_action('init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function () {
get_header();
echo bs_block([
'name' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
]);
get_footer();
},
['title' => 'Component gallery']
);
});
A rota disponibiliza /components/. O callback dela é executado dentro do buffer de saída de Blockstudio, para que os blocos renderizados recebam seus estilos, scripts, recursos UI incluídos e saída de Tailwind pelo fluxo normal. WordPress não transforma a rota correspondente em um 404 nem a redireciona para uma publicação.
Para uma família de URLs, defina prefix como true e forneça um callback de match. O callback recebe o caminho abaixo da rota e retorna o valor necessário para o renderer. Retornar null ou false deixa a solicitação para WordPress. Use urls para listar os caminhos que um build de pré-renderização estática deve incluir. Uma rota única, sem prefixo, inclui seu próprio caminho por padrão.
Virtual_Routes::urls() retorna URLs absolutas para integrações que montam um sitemap. Não adiciona automaticamente documentos virtuais ao sitemap de publicações de WordPress.
Consulte Rotas virtuais para ver a API completa e as opções.
Builds de pré-renderização mais precisos
Os builds em modo gráfico renderizados sobre HTTP agora registram os arquivos usados por cada rota: o template WordPress, templates e recursos de blocos renderizados, definições e layouts de páginas em arquivos, e dependências adicionadas por meio de blockstudio/render/dependencies.
No próximo build, build_plan() compara essas dependências. Alterar um template de bloco marca suas rotas dependentes para renderização, sem reconstruir todas as páginas não relacionadas. Alterações na configuração compartilhada ainda afetam o build inteiro, e rotas novas ou expiradas são renderizadas como antes.
Alterações apenas no banco de dados não são dependências de arquivos. Uma implantação que precise obter uma opção, publicação ou outro valor do banco de dados deve forçar um build ou renderizar explicitamente as URLs afetadas.
A versão também corrige alterações nas identidades do build durante a primeira renderização, mapas de disponibilização antecipada desatualizados no cache de opcode e URLs válidas excluídas simplesmente porque o caminho contém search ou preview. Solicitações Markdown que usam Accept: text/markdown ignoram o HTML em cache, e as respostas relevantes enviam Vary: Accept.
A pré-renderização estática agora respeita os filtros registrados pelo tema ativo ao decidir se deve conectar seus hooks. Um tema pode desativar o recurso sem que uma consulta anterior às configurações o mantenha ativo.
Consulte Pré-renderização estática.
Retenção e manutenção do cache
Uma página HTML em cache pode durar mais que a identidade do runtime que compilou sua folha de estilo. cache.namespaceGrace controla por quanto tempo os namespaces desativados permanecem disponíveis após a limpeza detectar pela primeira vez que foram desativados:
{
"cache": {
"namespaceGrace": 777600
}
}
Este exemplo mantém os arquivos desativados por nove dias. O padrão é um dia. Namespaces ativos e namespaces que disponibilizam artefatos de pré-renderização implantados são protegidos da limpeza de itens desativados.
O mapa de disponibilização antecipada também tem comandos de inspeção e limpeza:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
Eles identificam e removem entradas de sites excluídos ou diretórios ausentes. A exclusão de um site de rede multisite também remove suas entradas. Documentos de rota ausentes são identificados separadamente, sem causar a remoção de uma entrada de site válida inteira.
Consulte Cache para orientações sobre retenção e manutenção do mapa para ver os comandos.
Um editor mais confiável
Editar um bloco selecionado em conjunto agora atualiza apenas esse bloco. Ao salvar, cada bloco mantém seu próprio conteúdo, chaves, metadados e bloqueios, em vez de copiar atributos entre os blocos selecionados.
Os valores de RichText ficam diretamente nos atributos do bloco, então Gutenberg pode incluí-los nas operações de desfazer e refazer. Os campos da barra lateral participam do mesmo histórico. InnerBlocks templateLock="false" é passado como um booleano real e desbloqueia o conteúdo mesmo quando uma área externa está bloqueada.
Os pré-carregamentos iniciais recebem o ID e o tipo da publicação editada, para que os templates possam ler os metadados corretos na primeira renderização. Blocos filhos idênticos em pais diferentes mantêm contextos herdados separados nos pré-carregamentos e caches de renderização. Alterações nos atributos ou no contexto durante uma solicitação inicial não deixam mais a prévia desatualizada.
Blockstudio também deixa de inserir elementos ocultos de marcação de renderização entre as raízes dos blocos. Seletores de irmãos adjacentes, como .card + .card, agora encontram as mesmas relações entre elementos no editor e no frontend, enquanto as renderizações de prévia do editor e do inseridor continuam separadas.
Armazenamento mais seguro de opções em todo o site
Campos vinculados a opções continuam fornecendo valores para todo o site, mas salvar uma publicação já não grava indiscriminadamente todas as cópias salvas desses campos:
- Rascunhos, publicações pendentes ou privadas e publicações agendadas não gravam opções ativas do site.
- Publicações publicadas gravam os campos fornecidos que foram alterados nessa edição.
- Salvar apenas o título de uma cópia antiga não reverte um valor mais recente usado em todo o site.
- Campos ausentes e blocos removidos não excluem opções existentes.
- Uma operação explícita de
nullremove uma opção. Strings vazias,false, zero e arrays vazios continuam sendo valores válidos.
Esta é a principal mudança de comportamento a verificar durante a atualização. Se uma integração usava uma publicação privada ou um rascunho para atualizar uma opção ativa, grave essa opção explicitamente ou use uma publicação de configuração publicada. O armazenamento de metadados da publicação não é afetado pela restrição a publicações publicadas.
Consulte Armazenamento para ver todas as regras de salvamento.
O conteúdo dos arquivos permanece intacto
O fluxo de HTML para blocos preserva mais da estrutura que você escreveu:
- Listas aninhadas se tornam blocos de lista internos do item pai. As classes de lista e de item são preservadas; listas simples continuam com a saída anterior.
main,header,footer,articleeasidese tornam blocos de grupo que preservam o elemento, em vez de HTML bruto que ignora a renderização de blocos.- Parágrafos de rich text mapeados mantêm a marcação inline, parágrafos que contêm apenas uma imagem são resolvidos para o bloco de imagem mapeado, e tags de shortcode mantêm seu conteúdo.
- Atributos escapados são decodificados e escapados uma única vez, inclusive os atributos em
InnerBlocks,RichTexte no elementouseBlockProps. - Sinais de maior dentro de atributos entre aspas em tags autocontidas são aceitos.
- Atributos globais HTML chegam à raiz de um bloco Blockstudio quando o bloco não os declara como campos.
wp bs pages syncidentifica atributos armazenados que não são renderizados.
Páginas, padrões e templates do Editor do Site baseados em Blade agora são renderizados por meio de Blockstudio\Blade_Renderer, com suporte às versões 8 a 12 de illuminate/view. Todos os arquivos de extensão direcionados ao mesmo bloco são registrados, e suas prioridades, campos de grupo e listas de alvos seguem o esquema documentado.
As dependências aninhadas de SCSS também são rastreadas. Editar um parcial importado por outro parcial altera a versão da folha de estilo dependente e aciona a recompilação.
Melhorias em PHPStan
O pacote blockstudio/phpstan, instalado separadamente, amplia a validação de tags de bloco para incluir tags com prefixo e aliases, elementos de página mapeados, layouts, blocos UI incluídos e, opcionalmente, outras fontes PHP do projeto. A resolução de namespaces corresponde à do runtime, inclusive para namespaces com hífens, e atributos globais HTML encaminhados são aceitos.
Variáveis de template de bloco, como $a, $block e $context, são tratadas como definidas por Blockstudio. Os tipos de campo são mantidos em coalescência de nulos e isset() com PHPStan 2.3, enquanto um template que atribui seu próprio $a mantém o tipo que atribuiu.
Essas alterações estão incluídas em blockstudio/phpstan 0.1.9. Atualize o pacote separadamente do plugin; ele requer PHPStan 2.1.47 ou mais recente:
composer require --dev blockstudio/phpstan:^0.1.9
Consulte PHPStan para ver as configurações e os presets de análise.
Acessibilidade e traduções
Os controles UI incluídos expõem seu estado expandido no próprio botão. Os rótulos de caixas de seleção, interruptores e botões de opção identificam e alternam seus controles. Breadcrumbs, paginação, menus de navegação e tabelas já não inserem elementos de contêiner inválidos entre listas ou tabelas e seus itens.
Os controles de senha expõem seu estado pressionado e têm uma área de clique maior. As entradas aceitam autocomplete, e as entradas de senha aceitam um ID explícito e um rótulo acessível. As áreas de visualização do carrossel podem receber foco pelo teclado, e as animações de spinners e skeletons respeitam as preferências de movimento reduzido.
O editor e a visão geral de administração carregam as traduções instaladas de JavaScript para o domínio de texto blockstudio. Menus de atributos e placeholders, ações de popups de código e identificadores de imagem e arquivo agora podem ser traduzidos. Strings sem tradução permanecem em inglês.
Consulte a biblioteca UI e a configuração de traduções.
Documentação e atualização
A documentação inclui guias sobre sites de documentação, Content Sync, modelos do Editor do Site, tags de bloco, ilhas, tipos de campos personalizados, implantação, pré-renderização, configuração do registro, ferramentas de análise e telas do aplicativo UI. O guia de migração ACF reflete o registro atual de ACF e as Block Bindings.
Os exemplos de preenchimento personalizado agora usam o filtro de conjunto de dados nomeado com um único argumento, que é o método compatível. A documentação de recursos explica a ordem das folhas de estilo do frontend e como carregar substituições do tema após os blocos CSS. As instalações para contribuidores usam o pacote público do Font Awesome sem credenciais de registro.
PHP 8.2 e WordPress 6.7 continuam sendo os requisitos mínimos. As rotas virtuais e os novos comandos de manutenção estão disponíveis sem alterar as coleções de páginas existentes. Consulte acima as regras para salvar o armazenamento de opções, atualize o pacote separado PHPStan se você o utilizar e continue executando a sincronização de páginas explicitamente, como antes.
7.7.1 Acompanhamento
O patch 7.7.1 torna os resultados da sincronização mais claros e seguros. Uma mesclagem por chave que não altera uma publicação não cria mais uma revisão nem atualiza o carimbo de data e hora de modificação. Os status de publicação existentes são preservados, as substituições de título e slug controladas por arquivos são informadas, e as páginas bloqueadas ou removidas são identificadas no relatório CLI. O Content Sync marca os corpos controlados pelo Page Sync e mantém as cópias existentes para revisão. O patch também protege os atributos controlados por WordPress contra IDs de campo conflitantes e preserva as classes do editor adicionadas por outros filtros.