# 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.

[Prerenderizado estático](https://blockstudio.dev/es/docs/production/static-prerendering/)

blockstudio.json

```
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}
```

## 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](https://blockstudio.dev/es/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

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](https://blockstudio.dev/es/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

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.

[Entrega anticipada](https://blockstudio.dev/es/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Terminal

```
# 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 teardown
```

## Actualizado 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.

[Modos de firma y grafo](https://blockstudio.dev/es/docs/production/static-prerendering/#signature-and-graph-modes)

deploy.php

```
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']));
```

## 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.

[Configuración de CDN](https://blockstudio.dev/es/guides/static-prerendering/#putting-a-cdn-in-front)

nginx.conf

```
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;
}
```

## 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.

[Bloques isla](https://blockstudio.dev/es/docs/blocks/islands/)

block.json

```
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}
```

## 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.

[Generador de perfiles](https://blockstudio.dev/es/docs/production/performance/#profiler)

blockstudio.json

```
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}
```

## 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.

[Perfiles de rendimiento](https://blockstudio.dev/es/docs/production/performance/#performance-profiles)

blockstudio.json

```
{
  "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.

[Multimedia](https://blockstudio.dev/es/docs/production/media/)

index.php

```
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);
```

## [Un solo directorio de caché](https://blockstudio.dev/es/docs/production/caching/)

Todos los archivos generados se guardan en cache.path y se identifican mediante una identidad de ejecución.

## [Compilaciones de vuelo único](https://blockstudio.dev/es/docs/production/caching/#concurrency-and-retention)

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](https://blockstudio.dev/es/docs/production/performance/#render-cache)

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é](https://blockstudio.dev/es/docs/general/settings/#assets)

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](https://blockstudio.dev/es/docs/blocks/assets/registering/#inline-small-stylesheets)

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](https://blockstudio.dev/es/docs/blocks/assets/registering/#load-order)

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](https://blockstudio.dev/es/docs/blocks/assets/registering/#disable-enqueuing)

Una plantilla que no devuelve nada no pone recursos en cola. assets.enqueue false te deja gestionar todos los recursos.

## [Comandos de caché](https://blockstudio.dev/es/docs/dev/cli/)

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](https://blockstudio.dev/es/docs/blocks/hooks/php/#error-handling)

error/logged y error/exception reenvían errores Blockstudio a un registrador o sistema de seguimiento externo.

## [Renderizado por lotes](https://blockstudio.dev/es/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset() borra el estado de la solicitud entre documentos en un mismo proceso. render/dependencies enumera los archivos de cada bloque.

Plus

## 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

[Obtener Plus](https://blockstudio.dev/es/plus/)
