Estático cuando es posible
Páginas generadas previamente y valores predeterminados de producción, definidos en blockstudio.json.
Genera previamente páginas anónimas
El prerenderizado estático viene desactivado de forma predeterminada. Activa performance.staticPrerender y Blockstudio para guardar cada documento HTML completo que recibe un visitante anónimo y responder al siguiente visitante anónimo con esa copia.
Las solicitudes que deben mantenerse dinámicas nunca lo usan: solicitudes que no sean GET, cadenas de consulta, administración, REST, Ajax, cron, feeds, búsquedas, vistas previas, páginas con nonce, todas las rutas bajo dynamicPaths y visitantes con sesión iniciada, a menos que serveLoggedIn esté activado.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}<!-- blockstudio:no-cache -->
<p class="stock">
<?php echo esc_html( $a['label'] ); ?>
</p>Desactivado de forma predeterminada
Nada cambia hasta que blockstudio.json nombre la función.
Rutas dinámicas
Una ruta dinámica /account incluye /account/orders, pero no /accounting.
Marcador de exclusión
Un comentario blockstudio:no-cache mantiene cualquier respuesta fuera de la caché.
Visitantes con sesión iniciada
Con serveLoggedIn, pueden ver las páginas guardadas; sus propias páginas nunca se guardan.
Omisión personalizada
El filtro static_prerender/request_bypass excluye de las páginas almacenadas cualquier solicitud que indiques, como una que incluya una cookie del carrito.
Cola de calentamiento
Una cola persistente vuelve a generar las páginas obsoletas con el intervalo que establezcas.
Rutas de baja frecuencia
Las rutas que no están en el mapa desplegado también se sirven antes, una vez que WordPress las haya renderizado y almacenado.
Comprobación de hojas de estilo
Si falta la hoja de estilo Tailwind enlazada por una página almacenada, esta se vuelve a renderizar; nunca se sirve sin estilos.
Se sirve antes de que se inicie WordPress
Con earlyServe activado, Blockstudio instala un drop-in de advanced-cache.php que transmite una página guardada antes de que se carguen WordPress, los plugins o el tema. Nunca sobrescribe un drop-in, un mapa de rutas ni una línea de WP_CACHE que no haya escrito.
Este sitio lo ejecuta. El 8 de octubre de 2026, las páginas de blockstudio.dev respondieron con x-blockstudio-static-prerender: HIT-EARLY, el encabezado que envía el componente integrado.
# 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-EARLYActualizado después de cada cambio
El modo signature predeterminado llena la caché cuando un visitante anónimo no encuentra una página y la renueva tras los cambios en el sitio. Al guardar o eliminar una entrada, se purgan esa entrada y la página principal, o se ponen en cola para volver a generarse si el calentamiento está activado.
El modo graph está pensado para herramientas de despliegue. Registra los archivos que leyó cada página, de modo que una compilación vuelve a renderizar solo las rutas cuyos archivos cambiaron y luego activa el nuevo conjunto como un único artefacto. Si un archivo referenciado no supera la validación, el artefacto anterior sigue activo.
Al instalar un artefacto, se comparan los bytes y se sustituyen los documentos modificados de forma atómica. last_promotion() indica cuántas rutas se promocionaron, reemplazaron, omitieron o conservaron, para que un despliegue pueda registrarlo y compararlo con el ID de la compilación activa.
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();Detrás de un CDN
El encabezado de prerenderizado ya indica qué respuestas se pueden compartir de forma segura. Asigna HIT y HIT-EARLY a una duración Cache-Control en el servidor de origen, almacena en caché solo las respuestas que incluyan una y evita el nodo perimetral para las cookies wordpress_logged_in_, wp-postpass_ y comment_author_email_, así como para tu dynamicPaths, wp-admin y wp-json.
Las páginas almacenadas en caché en el nodo perimetral siguen enlazando la hoja de estilo con hash de contenido con la que se renderizaron. Aumenta cache.namespaceGrace hasta el tiempo máximo que puede durar una copia de ese tipo, y las hojas de estilo retiradas permanecerán en el disco hasta que venza.
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"
}
}Un bloque activo en una página en caché
Configura blockstudio.island como dynamic y la página en caché incluirá un marcador de posición en lugar del bloque. El navegador reúne todas las islas dinámicas de la página y obtiene sus fragmentos en una sola solicitud por lotes; cada uno se firma con el nombre del bloque y sus atributos permitidos.
hydrate conserva el HTML completo en la página y solo envía un evento de montaje. Las islas dinámicas pueden esperar a que sean visibles, actualizarse cuando se active un evento de ventana y almacenar fragmentos en caché por usuario o de forma global.
{
"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'));Consulta en qué se va el tiempo de renderizado
Añade ?blockstudio-perf a cualquier URL del frontend y un panel mostrará los tiempos de renderizado por bloque, el número de llamadas y las fases de transformación, plantilla y componente. Los mismos tiempos se envían en encabezados Server-Timing, que siguen funcionando cuando un CDN almacena en caché el HTML.
Solo los usuarios con sesión iniciada y edit_posts pueden ver el resultado; para cualquier otra solicitud, el generador de perfiles se desactiva en init. performance.measurement añade encabezados con el perfil y el hash de configuración, además de un Performance_Measurement::snapshot() API.
{
"dev": {
"perf": true
},
"performance": {
"measurement": {
"enabled": true,
"headers": true,
"timings": true
}
}
}use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();Un solo interruptor para los valores predeterminados de producción
Al establecer performance.profile en speed, se eliminan del encabezado la información del generador, los emojis, los feeds y los datos de descubrimiento; se elimina el descubrimiento de oEmbed; se desactivan XML-RPC y los pingbacks; se quitan los recursos genéricos del núcleo para el frontend; se limita Heartbeat fuera de los editores y se anticipa la carga de enlaces del mismo origen al pasar el cursor o al enfocarlos.
El valor predeterminado es compat, que no cambia nada. Cada valor secundario prevalece sobre el perfil, así que puedes conservar un comportamiento y usar los demás valores.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}Imágenes que conservan su espacio
Las imágenes del tema están fuera de la biblioteca de medios, así que WordPress no conoce sus dimensiones. bs_media_image() lee las dimensiones reales de un assets/media.json generado y reserva la proporción antes de que se cargue el archivo.
Activa performance.media.lazy y la URL real esperará detrás de un marcador de posición del tamaño correcto hasta que la imagen se acerque al área visible.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'eager' => true,
]);{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}Un solo directorio de caché
Todos los archivos generados se guardan en cache.path y se identifican mediante una identidad de ejecución.
Compilaciones de vuelo único
Una solicitud crea una clave de caché que aún no está almacenada. Las demás esperan, reutilizan la última carga útil válida o reciben un 503 con Retry-After.
Cargas útiles compatibles con OPcache
Las cargas útiles pequeñas de la caché son matrices PHP simples que OPcache puede reutilizar desde la memoria compartida. Las más grandes se mantienen comprimidas.
Caché de renderizado
Una etiqueta de bloque de cierre automático con los mismos atributos se renderiza una vez por solicitud. Las repeticiones se sirven desde la memoria.
Actualización agrupada de opciones
Una ráfaga de escrituras de contenido, como una importación, se convierte en una sola actualización de las opciones de campos pobladas y almacenadas en caché.
Cachés multiinquilino
Filtra cache/site_key para definir los límites de tus propios inquilinos y cache/context para las variantes de ejecución del mismo sitio.
Recursos compilados en la caché
Con assets.output configurado como cache, los recursos compilados salen del árbol de bloques, así que se puede desplegar desde una copia inmutable.
Compilaciones fragmentadas
Static_Prerender_Batch_Renderer divide una compilación en fragmentos estables N/TOTAL, y quien realiza la llamada puede calcular la misma partición.
Insertar hojas de estilo pequeñas
assets.inlineLimit inserta en línea las hojas de estilo más pequeñas de los bloques, dentro de un límite de bytes y en el mismo orden de cascada.
Bloque CSS al final del encabezado
El bloque CSS se añade justo antes de la etiqueta de cierre del encabezado, después de las hojas de estilo del tema y de los plugins.
Omitir recursos sin usar
Una plantilla que no devuelve nada no pone recursos en cola. assets.enqueue false te deja gestionar todos los recursos.
Comandos de caché
wp bs cache status, cleanup y clear inspeccionan, vacían y purgan la caché de ejecución. wp bs prerender purge elimina las páginas almacenadas.
Desinstalación limpia
wp bs teardown elimina únicamente el estado que pertenece a esta instalación.
Ganchos de resultados
cache/outcome y static_prerender/outcome informan de aciertos, compilaciones, fallos de caché y errores en sus métricas.
Hooks de errores
error/logged y error/exception reenvían errores Blockstudio a un registrador o sistema de seguimiento externo.
Renderizado por lotes
Batch_Render::reset() borra el estado de la solicitud entre documentos en un mismo proceso. render/dependencies enumera los archivos de cada bloque.
El kit oficial de extensiones
Plantillas de sitio prémium, instrucciones de sistema para IA y una comunidad privada de Discord. Compra única, actualizaciones de por vida.
- Más de 500 plantillas de sitios web
- Instrucciones del sistema de IA
- Actualizaciones de por vida
- Comunidad privada de Discord