Dennis · 14 de octubre de 2026
Blockstudio 7.7
Blockstudio 7.7 añade rutas virtuales para documentos sin una entrada WordPress, mejora las compilaciones específicas de prerenderizado y hace más fiables la edición y el renderizado de los bloques existentes. También amplía las comprobaciones de etiquetas de bloques de PHPStan y mejora la accesibilidad de los componentes incluidos de UI.
El flujo de trabajo basado en archivos se mantiene igual. Los bloques se renderizan desde sus plantillas y las páginas basadas en archivos se actualizan mediante una sincronización explícita de CLI o API. Esta versión no introduce la sincronización automática de páginas en las solicitudes de visitantes o administración.
En resumen:
- Rutas virtuales: sirva una galería de componentes, un catálogo u otro documento completo sin crear una entrada ni escribir un controlador de redirecciones personalizado.
- Compilaciones específicas de prerenderizado: las compilaciones de HTTP registran los archivos de origen que usa cada página, para que una compilación posterior pueda renderizar solo las rutas afectadas.
- Retención de caché: mantenga disponibles las hojas de estilo retiradas para las páginas en caché e inspeccione o depure las entradas sin usar del mapa de servicio anticipado.
- Fiabilidad del editor: los bloques seleccionados a la vez conservan sus propios valores; deshacer y rehacer funciona con RichText y los campos de la barra lateral, y el contexto heredado permanece con el bloque correcto.
- Fidelidad del contenido de archivos: las listas anidadas, los elementos de seccionamiento, el contenido integrado HTML, los shortcodes y los atributos escapados se conservan al analizar y renderizar.
- Mejoras de PHPStan: las etiquetas con prefijo, los alias, los elementos de página asignados y las variables de plantilla se comprueban según las definiciones del propio proyecto.
- UI accesibles: los controles muestran correctamente su estado, las etiquetas activan el campo adecuado y los componentes de listas y tablas usan una estructura HTML válida.
- Traducciones: las traducciones instaladas de JavaScript se cargan en el editor y en la vista general de administración, incluidos los controles de campos que antes no estaban traducidos.
Rutas virtuales
Algunas páginas provienen de datos y no de una entrada administrada por el editor. Por ejemplo, la referencia de un componente puede necesitar su propia URL y un título de documento, pero no una entrada en wp_posts.
Registre ese documento con 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']
);
});
La ruta sirve /components/. Su callback se ejecuta dentro del búfer de salida de Blockstudio, por lo que los bloques renderizados reciben sus estilos, scripts, recursos de UI incluidos y salida de Tailwind mediante el flujo habitual. WordPress no convierte la ruta coincidente en un 404 ni la redirige a una entrada.
Para una familia de URL, establezca prefix en true y proporcione un callback match. El callback recibe la ruta que sigue a la ruta base y devuelve el valor que necesita el renderizador. Si devuelve null o false, la solicitud queda en manos de WordPress. Use urls para enumerar las rutas que debe incluir una compilación de prerenderizado estático. De forma predeterminada, una ruta única que no sea de prefijo incluye su propia ruta.
Virtual_Routes::urls() devuelve URL absolutas para las integraciones que generan un mapa del sitio. No añade automáticamente documentos virtuales al mapa del sitio de entradas de WordPress.
Consulte Rutas virtuales para ver la API completa y las opciones.
Compilaciones de prerenderizado más precisas
Las compilaciones en modo de grafo que se renderizaban con HTTP ahora registran los archivos que usó cada ruta: la plantilla WordPress, las plantillas y los recursos de los bloques renderizados, las definiciones y diseños de páginas basadas en archivos, y las dependencias añadidas mediante blockstudio/render/dependencies.
En la siguiente compilación, build_plan() compara esas dependencias. Si cambia una plantilla de bloque, se marcan sus rutas dependientes para renderizarlas sin volver a compilar las páginas no relacionadas. Los cambios en la configuración compartida siguen afectando a toda la compilación, y las rutas nuevas o caducadas se renderizan como antes.
Los cambios que solo afectan a la base de datos no son dependencias de archivos. Para que un despliegue recoja una opción, una entrada u otro valor de la base de datos, debe forzar una compilación o renderizar explícitamente las URL afectadas.
La versión también corrige los cambios de identidad de la compilación durante el primer renderizado, los mapas obsoletos de servicio anticipado almacenados en la caché de código de operación y la exclusión de URL válidas solo porque su ruta contiene search o preview. Las solicitudes Markdown que usan Accept: text/markdown omiten HTML en caché, y las respuestas pertinentes envían Vary: Accept.
El prerenderizado estático ahora respeta los filtros registrados por el tema activo al decidir si debe añadir sus hooks. Un tema puede desactivar la función sin que una consulta previa a la configuración la deje activa.
Consulte Prerenderizado estático.
Retención y mantenimiento de caché
Una página HTML en caché puede seguir disponible más tiempo que la identidad del entorno de ejecución que compiló su hoja de estilos. cache.namespaceGrace controla cuánto tiempo permanecen disponibles los espacios de nombres retirados desde que la limpieza detecta por primera vez su retirada:
{
"cache": {
"namespaceGrace": 777600
}
}
Este ejemplo conserva los archivos retirados durante nueve días. El valor predeterminado es un día. Los espacios de nombres activos y los que sirven artefactos de prerenderizado desplegados están protegidos frente a la limpieza de retirados.
El mapa de servicio anticipado también dispone de comandos de inspección y limpieza:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
Estos comandos informan y eliminan las entradas de sitios borrados o directorios que faltan. Al eliminar un sitio de una instalación multisitio, también se eliminan sus entradas. Los documentos de ruta que faltan se informan por separado, sin provocar la eliminación de toda una entrada válida del sitio.
Consulte Almacenamiento en caché para obtener recomendaciones de retención y mantenimiento del mapa para ver los comandos.
Un editor más fiable
Al editar un bloque entre varios seleccionados, ahora solo se actualiza ese bloque. Al guardar, cada bloque conserva su propio contenido, claves, metadatos y bloqueos, en vez de copiar atributos entre los bloques seleccionados.
Los valores RichText se guardan directamente en los atributos del bloque, por lo que Gutenberg puede incluirlos al deshacer y rehacer. Los campos de la barra lateral forman parte del mismo historial. InnerBlocks templateLock="false" se pasa como un booleano real y permite editar el contenido aunque un área externa esté bloqueada.
Las precargas iniciales reciben el ID y el tipo de la entrada editada, para que las plantillas puedan leer los metadatos correctos desde el primer renderizado. Los bloques secundarios idénticos bajo distintos bloques principales mantienen contextos heredados separados en las precargas y las cachés de renderizado. Los cambios de atributos o de contexto durante una solicitud inicial ya no dejan la vista previa desactualizada.
Blockstudio también deja de insertar elementos ocultos de marcador de renderizado entre las raíces de los bloques. Los selectores de hermanos adyacentes como .card + .card ahora detectan las mismas relaciones entre elementos en el editor que en la interfaz pública, mientras que las vistas previas del editor y del insertador siguen renderizándose por separado.
Almacenamiento más seguro de opciones para todo el sitio
Los campos respaldados por opciones siguen proporcionando valores para todo el sitio, pero al guardar una entrada ya no se escriben a ciegas todas las copias guardadas de esos campos:
- Los guardados de borradores, entradas pendientes o privadas, y entradas programadas no escriben opciones activas del sitio.
- Los guardados de entradas publicadas escriben los campos proporcionados que cambiaron en esa edición.
- Guardar solo el título de una copia antigua no revierte un valor más reciente para todo el sitio.
- Los campos que faltan y los bloques eliminados no borran las opciones existentes.
- Un
nullexplícito elimina una opción. Las cadenas vacías,false, el cero y los arrays vacíos siguen siendo valores válidos.
Este es el principal cambio de comportamiento que debe comprobar al actualizar. Si una integración usaba una entrada privada o un borrador para actualizar una opción activa, escriba esa opción explícitamente o use en su lugar una entrada de configuración publicada. El almacenamiento de metadatos de entradas no se ve afectado por la restricción que solo permite publicar.
Consulte Almacenamiento para ver todas las reglas de guardado.
El contenido de los archivos se conserva intacto
El flujo de conversión de HTML a bloques conserva mejor la estructura que ha escrito:
- Las listas anidadas se convierten en bloques de lista internos del elemento principal. Se conservan las clases de las listas y sus elementos; las listas planas habituales mantienen su salida anterior.
main,header,footer,articleyasidese convierten en bloques de grupo que conservan su elemento, en lugar de convertirse en HTML sin procesar que omite el renderizado de bloques.- Los párrafos de texto enriquecido asignados conservan el marcado integrado; los párrafos que solo contienen imágenes se convierten en el bloque de imagen asignado y las etiquetas de shortcode conservan su contenido.
- Los atributos escapados se decodifican y se vuelven a escapar una sola vez, incluidos los atributos de
InnerBlocks,RichTexty el elementouseBlockProps. - Se aceptan los signos mayor que dentro de los atributos entre comillas de etiquetas de cierre automático.
- Los atributos globales HTML llegan a la raíz de un bloque Blockstudio cuando el bloque no los declara como campos.
wp bs pages syncinforma de los atributos almacenados que no se renderizan.
Las páginas, los patrones y las plantillas del editor del sitio respaldados por Blade ahora se renderizan mediante Blockstudio\Blade_Renderer, con compatibilidad para las versiones 8 a 12 de illuminate/view. Se registran todos los archivos de extensión dirigidos al mismo bloque, y su prioridad, los campos de grupo y las listas de objetivos siguen el esquema documentado.
También se registran las dependencias anidadas de SCSS. Si se edita un fragmento importado por otro, cambia la versión de la hoja de estilos dependiente y se activa su recompilación.
Mejoras de PHPStan
El paquete blockstudio/phpstan, que se instala por separado, amplía la validación de etiquetas de bloques a etiquetas con prefijo y alias, elementos de página asignados, diseños, bloques UI incluidos y, de forma opcional, otras fuentes PHP del proyecto. La resolución de espacios de nombres coincide con la del entorno de ejecución, incluidos los que contienen guiones, y se aceptan los atributos globales reenviados de HTML.
Las variables de plantilla de bloque, como $a, $block y $context, se consideran definidas por Blockstudio. Los tipos de campo se conservan con la fusión de valores nulos y isset() en PHPStan 2.3, mientras que se conserva el tipo que asigne una plantilla a su propio $a.
Estos cambios se incluyen en blockstudio/phpstan 0.1.9. Actualice el paquete por separado del plugin; requiere PHPStan 2.1.47 o posterior:
composer require --dev blockstudio/phpstan:^0.1.9
Consulte PHPStan para ver la configuración y los ajustes preestablecidos de análisis.
Accesibilidad y traducciones
Los activadores incluidos de UI exponen su estado expandido en el propio botón. Las etiquetas de casillas de verificación, interruptores y botones de opción identifican sus controles y permiten activarlos. Las migas de pan, la paginación, los menús de navegación y las tablas ya no insertan elementos envolventes no válidos entre listas o tablas y sus elementos secundarios.
Los controles para mostrar u ocultar contraseñas exponen su estado de pulsación y tienen un área de clic más grande. Los campos aceptan autocomplete, y los campos de contraseña aceptan un ID y una etiqueta accesible explícitos. Las ventanas gráficas del carrusel se pueden enfocar con el teclado, y las animaciones de los indicadores de carga y las estructuras esqueléticas respetan las preferencias de movimiento reducido.
El editor y la vista general de administración cargan las traducciones instaladas de JavaScript para el dominio de texto blockstudio. Los menús de atributos y los textos de ejemplo, las acciones de las ventanas emergentes de código y las insignias de imágenes y archivos ahora se pueden traducir. Las cadenas sin traducción permanecen en inglés.
Consulte la bibliotecaUI de y la configuración de traducciones.
Documentación y actualización
La documentación añade guías sobre sitios de documentación, Content Sync, plantillas del editor del sitio, etiquetas de bloques, islas, tipos de campos personalizados, implementación, prerrenderizado, configuración del registro, herramientas de análisis y pantallas de la aplicación UI. La guía de migración ACF refleja el registro actual de ACF y Block Bindings.
Los ejemplos de población personalizada ahora usan el filtro de conjuntos de datos con nombre y un solo argumento que está admitido. La documentación de recursos explica el orden de las hojas de estilo del frontend y cómo cargar las sobrescrituras del tema después de los recursos de bloque CSS. Las instalaciones para colaboradores usan el paquete público de Font Awesome sin credenciales del registro.
PHP 8.2 y WordPress 6.7 siguen siendo los requisitos mínimos. Las rutas virtuales y los nuevos comandos de mantenimiento están disponibles sin cambiar las colecciones de páginas existentes. Revise las reglas de guardado del almacenamiento de opciones anteriores, actualice el paquete independiente de PHPStan si lo usa y siga ejecutando la sincronización de páginas explícitamente como antes.
7.7.1 Seguimiento
El parche 7.7.1 hace que los resultados de sincronización sean más claros y seguros. Una combinación por clave que no modifica una entrada ya no crea una revisión ni actualiza su fecha de modificación. Se conservan los estados de publicación existentes, se informa de las sustituciones del título y el slug controladas por archivos, y se nombran las páginas bloqueadas o eliminadas en el informe CLI. Content Sync marca los cuerpos controlados por Page Sync y conserva las copias de revisión existentes. El parche también protege los atributos controlados por WordPress frente a IDs de campo en conflicto y conserva las clases del editor añadidas por otros filtros.