Estático quando possível
Páginas pré-renderizadas e padrões de produção definidos em blockstudio.json.
Pré-renderize páginas anônimas
A pré-renderização estática vem desativada por padrão. Ative performance.staticPrerender para que Blockstudio armazene cada documento HTML completo recebido por um visitante anônimo e responda ao próximo visitante anônimo com essa cópia.
As solicitações que precisam continuar ativas nunca o acessam: solicitações que não sejam GET, strings de consulta, administração, REST, Ajax, cron, feeds, pesquisa, pré-visualizações, páginas com nonce, todos os caminhos sob dynamicPaths e visitantes com sessão iniciada, a menos que serveLoggedIn esteja ativado.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}<!-- blockstudio:no-cache -->
<p class="stock">
<?php echo esc_html( $a['label'] ); ?>
</p>Desativado por padrão
Nada muda até que blockstudio.json nomeie o recurso.
Caminhos dinâmicos
Um caminho dinâmico /account abrange /account/orders, mas não /accounting.
Marcador de exclusão
Um comentário blockstudio:no-cache mantém qualquer resposta fora do cache.
Visitantes com sessão iniciada
Com serveLoggedIn, eles leem páginas armazenadas; as páginas deles nunca são armazenadas.
Desvio personalizado
O filtro static_prerender/request_bypass mantém fora das páginas armazenadas qualquer solicitação que você especificar, como uma que contenha um cookie de carrinho.
Fila de aquecimento
Uma fila persistente renderiza novamente páginas desatualizadas no intervalo definido.
Rotas de cauda longa
As rotas que não estão no mapa implantado também são servidas antecipadamente, assim que WordPress as renderiza e armazena.
Verificação da folha de estilos
Uma página armazenada cujo arquivo da folha de estilos Tailwind vinculada não existe é renderizada novamente, nunca servida sem estilos.
Servido antes da inicialização de WordPress
Com earlyServe ativado, Blockstudio instala um drop-in de advanced-cache.php que transmite uma página armazenada antes do carregamento de WordPress, dos plugins ou do tema. Ele nunca sobrescreve um drop-in, um mapa de rotas ou uma linha de WP_CACHE que não tenha escrito.
Este site o utiliza. Em 8 de outubro, 2026, as páginas de blockstudio.dev responderam com x-blockstudio-static-prerender: HIT-EARLY, o cabeçalho enviado pelo drop-in.
# Identity, files, queue, and hit/miss counters
wp bs prerender status
# Re-render stale entries now
wp bs prerender warm
# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run
# Remove the drop-in and map this install owns
wp bs teardowncurl -sI https://blockstudio.dev/ | grep -i x-blockstudio
# x-blockstudio-static-prerender: HIT-EARLYAtualizado após cada alteração
O modo padrão signature preenche o cache quando não há correspondência para um visitante anônimo e o renova após alterações no site. Ao salvar ou excluir uma publicação, ela e a página inicial são removidas do cache ou colocadas na fila para renderização novamente quando o aquecimento está ativado.
O modo graph é destinado a ferramentas de implantação. Ele registra os arquivos lidos por cada página, para que uma compilação renderize novamente apenas as rotas cujos arquivos foram alterados e, em seguida, ative o novo conjunto como um único artefato. Se um arquivo referenciado falhar na validação, o artefato anterior continua ativo.
A instalação de um artefato compara os bytes e substitui atomicamente os documentos alterados. last_promotion() informa quantas rotas foram promovidas, substituídas, ignoradas ou mantidas, para que uma implantação possa registrar esse dado e comparar o ID da compilação ativa.
use Blockstudio\Static_Prerender_Runtime;
$plan = Static_Prerender_Runtime::build_plan($sourceUrls);
foreach ($plan['affectedUrls'] as $url) {
$result = render_with_dependencies($url);
Static_Prerender_Runtime::persist_built_response(
$url,
$result['html'],
$result['files'],
$result['virtualHashes']
);
}
Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));use Blockstudio\Static_Prerender_Early_Serve;
use Blockstudio\Static_Prerender_Runtime;
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
$counts = Static_Prerender_Early_Serve::last_promotion();Por trás de um CDN
O cabeçalho de pré-renderização já indica quais respostas podem ser compartilhadas com segurança. Associe HIT e HIT-EARLY a um tempo de vida Cache-Control na origem, armazene em cache apenas o que tiver esse tempo e ignore o cache da borda para os cookies wordpress_logged_in_, wp-postpass_ e comment_author_email_, seu dynamicPaths, wp-admin e wp-json.
As páginas armazenadas em cache na borda continuam apontando para a folha de estilos com hash de conteúdo usada na renderização. Aumente cache.namespaceGrace para o maior tempo que uma cópia dessas pode permanecer ativa, e as folhas de estilo aposentadas ficarão no disco até esse prazo expirar.
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
"~^HIT" "public, s-maxage=604800";
default "";
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php-fpm.sock;
add_header Cache-Control $edge_cache_control;
}{
"cache": {
"namespaceGrace": 777600
},
"tailwind": {
"enabled": true,
"output": "link"
}
}Um bloco ativo em uma página em cache
Defina blockstudio.island como dynamic, e a página em cache levará um espaço reservado no lugar do bloco. O navegador reúne todas as ilhas dinâmicas da página e busca seus fragmentos em uma única solicitação em lote, cada um assinado com o nome do bloco e seus atributos permitidos.
hydrate mantém o HTML completo na página e envia apenas um evento de montagem. As ilhas dinâmicas podem aguardar até ficarem visíveis, atualizar quando um evento da janela for disparado e armazenar fragmentos em cache por usuário ou globalmente.
{
"name": "acme/cart-count",
"title": "Cart count",
"blockstudio": {
"island": {
"mode": "dynamic",
"attributes": ["productId"],
"loading": "visible",
"event": "cart:updated",
"cache": {
"ttl": 60,
"per": "user"
}
}
}
}<div class="cart-count-placeholder">
Loading cart...
</div>window.dispatchEvent(new Event('cart:updated'));Veja onde o tempo de renderização é gasto
Adicione ?blockstudio-perf a qualquer URL do front-end para exibir em um painel os tempos de renderização por bloco, a quantidade de chamadas e as etapas de transformação, modelo e componente. Os mesmos tempos são enviados como cabeçalhos Server-Timing, que continuam funcionando quando um CDN armazena o HTML em cache.
Somente usuários com sessão iniciada e edit_posts veem a saída; todas as outras solicitações desativam o criador de perfil em init. performance.measurement adiciona cabeçalhos de perfil e hash de configuração, além de um Performance_Measurement::snapshot() API.
{
"dev": {
"perf": true
},
"performance": {
"measurement": {
"enabled": true,
"headers": true,
"timings": true
}
}
}use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();Uma chave para os padrões de produção
Com performance.profile definido como speed, são removidas do cabeçalho as saídas do gerador, dos emojis, dos feeds e da descoberta; a descoberta via oEmbed é removida; XML-RPC e os pingbacks são desativados; os recursos genéricos do frontend do núcleo são removidos; o Heartbeat é limitado fora dos editores; e links da mesma origem são pré-carregados ao passar o cursor ou receber foco.
O padrão é compat, que não altera nada. Cada valor secundário substitui o perfil, permitindo manter um comportamento e adotar os demais.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}Imagens que preservam seu espaço
As imagens do tema ficam fora da biblioteca de mídia, então WordPress não conhece suas dimensões. bs_media_image() lê as dimensões reais de um assets/media.json gerado e reserva a proporção antes de o arquivo carregar.
Ative performance.media.lazy e a imagem real de URL ficará atrás de um espaço reservado com o tamanho correto até se aproximar da área visível.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'eager' => true,
]);{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}Um único diretório de cache
Todos os arquivos gerados ficam em cache.path, identificados por uma identidade de tempo de execução.
Compilações de execução única
Uma solicitação compila uma chave de cache ainda não carregada. As demais aguardam, reutilizam o último payload válido ou recebem um 503 com Retry-After.
Payloads compatíveis com OPcache
Payloads pequenos em cache são arrays PHP simples que o OPcache pode reutilizar da memória compartilhada. Os maiores permanecem compactados.
Cache de renderização
Uma tag de bloco autocontida com os mesmos atributos é renderizada uma vez por solicitação. As repetições vêm da memória.
Atualização agrupada de opções
Uma série de gravações de conteúdo, como uma importação, resulta em uma única atualização das opções preenchidas de campos armazenadas em cache.
Caches multi-inquilino
Filtre cache/site_key para definir o limite do seu próprio inquilino e cache/context para variantes de execução do mesmo site.
Recursos compilados no cache
Com assets.output definido como cache, os recursos compilados saem da árvore de blocos, permitindo implantar a partir de um checkout imutável.
Compilações fragmentadas
Static_Prerender_Batch_Renderer divide uma compilação em fragmentos estáveis N/TOTAL, e quem faz a chamada pode calcular a mesma partição.
Incorporar folhas de estilo pequenas
assets.inlineLimit insere em linha as folhas de estilo menores dos blocos, dentro de um limite de bytes e na mesma ordem da cascata.
Colocar CSS por último no head
CSS do bloco é adicionado logo antes da tag de fechamento do head, depois das folhas de estilo do tema e dos plugins.
Ignorar recursos não utilizados
Um modelo que não retorna nada não enfileira recursos. assets.enqueue false deixa todos os recursos sob seu controle.
Comandos de cache
wp bs cache status, cleanup e clear inspecionam, esvaziam e limpam o cache de execução. wp bs prerender purge remove as páginas armazenadas.
Remoção limpa
wp bs teardown remove apenas o estado pertencente a esta instalação.
Hooks de resultado
cache/outcome e static_prerender/outcome reportam ocorrências, compilações, falhas de cache e erros às suas métricas.
Hooks de erro
error/logged e error/exception encaminham erros Blockstudio para um logger ou rastreador externo.
Renderização em lote
Batch_Render::reset() limpa o estado da solicitação entre documentos no mesmo processo. render/dependencies lista os arquivos de cada bloco.
O kit oficial de extensões
Modelos premium de site, instruções de sistema para IA e uma comunidade privada Discord. Compra única, atualizações vitalícias.
- 500+ modelos de sites
- Instruções de sistema para IA
- Atualizações vitalícias
- Comunidade privada de Discord