Dennis · 23 de julio de 2026
Blockstudio 7.5
Blockstudio La versión 7.5 completa el flujo de trabajo centrado en archivos de Blockstudio: tipos de campos personalizados, plantillas del Editor del sitio basadas en archivos, islas de bloques, almacenamiento de base de datos Storh, fuentes de detección lógicas, etiquetas de bloques componibles y rutas de implementación y ejecución más rápidas.
Los campos personalizados reutilizables ya permiten que los proyectos definan una vez un grupo de campos existentes y lo reutilicen con type: "custom/{name}". Los tipos de campos personalizados resuelven otro problema: permiten que un tema o plugin registre un nuevo tipo de campo con espacio de nombres, proporcione su propio control de edición y almacene el valor como datos Blockstudio normales.
En resumen:
- Fuentes de descubrimiento lógico: los entornos de ejecución pueden proporcionar un inventario lógico de temas compuesto, incluidos el origen y la identidad de caché, mientras que Blockstudio conserva la responsabilidad del descubrimiento, la resolución de archivos hermanos, los recursos generados, Canvas y el comportamiento de Tailwind.
- Registro de tipos de campo PHP: los temas y plugins pueden registrar tipos de campo con espacio de nombres, como
acme/dimensionsconbs_register_field_type()o el filtroblockstudio/field_types. - Registro de controles del editor: los scripts personalizados del editor pueden llamar a
window.blockstudio.registerFieldType()y mostrar el control React correspondiente en el UI normal del campo Blockstudio. - Valores estructurados: los campos personalizados pueden almacenar cadenas, números, valores booleanos, matrices u objetos sin someter los valores de objeto a la normalización de campos de opciones.
- Compatibilidad con el almacenamiento: los campos personalizados de metadatos de entradas y basados en opciones pueden declarar su tipo de valor y el esquema REST, incluidos los valores de objeto y matriz.
- Integración nativa: los tipos de campo personalizados funcionan dentro de grupos, pestañas, repetidores, campos personalizados reutilizables, plantillas y rutas de plantillas de extensiones.
- Plantillas del Editor del sitio: los temas pueden definir fuentes
wp_templateywp_template_parta partir de archivos de plantillatemplate.json,part.jsony Blockstudio. - Islas de bloques: los bloques pueden mostrar primero una estructura segura para la caché y luego hidratar o recuperar en lote fragmentos específicos de la solicitud una vez cargada la página.
- Almacenamiento en base de datos Storh:
bs.dbpuede usar un almacén indexado con un archivo por registro en las cargas, conservar los ID enteros públicos y migrar de JSONC a Storh mediante WP-CLI. - Mejoras del analizador y bsui: los párrafos de texto enriquecido asignados requieren menos código de integración personalizado para el analizador;
InnerBlockspuede usarallowedBlockstokenizado; la salida debs_render_block()anidado coincide con el renderizado del frontend en las vistas previas del editor; ybsui/buttonincorpora iconos y puntos de extensión de estilo más sencillos. - Etiquetas de bloques componibles: las etiquetas con prefijo pueden resolverse a través de otro prefijo (de
<theme-ui-input>absui/input), y las etiquetas con prefijo y alias se muestran en la salida de las plantillas de bloques, no solo en el contenido de las páginas. - Cachés de compilación seguras para el host: las cachés del entorno de ejecución y del editor ahora se guardan de forma predeterminada fuera de las cargas, admiten ubicaciones configurables y eliminan entradas obsoletas para evitar que los proyectos de larga duración acumulen archivos de caché.
- Conciliación incremental de páginas: las herramientas de despliegue pueden conciliar el inventario completo de páginas basadas en archivos, omitir las entradas sin cambios, informar exactamente de lo que cambió y guardar una identidad de origen verificada después de la activación.
- Renderizado en caliente más rápido: las cachés válidas del entorno de ejecución se hidratan antes del descubrimiento; las solicitudes simultáneas en frío publican un único resultado atómico; y Tailwind conserva una caché del tamaño del sitio con estado del compilador reutilizable.
- Renderizado seguro por lotes: los exportadores pueden restablecer el estado de renderizado de cada solicitud entre documentos sin reconstruir el descubrimiento y recopilar dependencias de origen mientras se renderizan los bloques.
Nuevas funciones
La versión 7.5 incorpora un amplio conjunto de nuevas capacidades para el descubrimiento, las plantillas y el almacenamiento.
Fuentes de descubrimiento lógico
Blockstudio normalmente descubre archivos de directorios físicos de temas. La versión 7.5 añade una fuente de nivel inferior, API, para entornos de ejecución que ensamblan un tema a partir de capas superpuestas, vistas previas, archivos generados, montajes remotos u otros inventarios compuestos.
Una integración puede proporcionar un árbol lógico final de archivos mientras Blockstudio conserva la responsabilidad de los bloques, campos, páginas, patrones, el Editor del sitio, Canvas, los recursos y el comportamiento de Tailwind:
use Blockstudio\Inventory_Discovery_Source;
add_filter(
'blockstudio/discovery/sources',
function (array $sources, string $context): array {
if ('blocks' !== $context) {
return $sources;
}
return [
new Inventory_Discovery_Source(
'preview:feature-card',
'/runtime-preview/feature-card/blockstudio',
[
'card/block.json' => [
'path' => '/theme/blockstudio/card/block.json',
'provenance' => ['layer' => 'parent'],
],
'card/index.php' => [
'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
'provenance' => ['layer' => 'preview'],
],
],
'preview-fingerprint'
),
];
},
10,
2
);
Las rutas lógicas permanecen estables aunque los archivos hermanos provengan de distintas raíces físicas. Los ID de origen y las huellas digitales alimentan las identidades de caché del entorno de ejecución y de Tailwind; los cambios en las entradas observadas las invalidan, y el origen determina dónde se pueden escribir los archivos generados. La fuente del sistema de archivos predeterminada no cambia para los temas normales.
Plantillas del Editor del sitio basadas en archivos
Las páginas y los patrones ya permiten a los equipos mantener estructuras de contenido en archivos. La versión 7.5 extiende ese modelo al propio Editor del sitio.
theme/
templates/
front-page/
template.json
index.php
parts/
header/
part.json
index.php
{
"slug": "front-page",
"title": "Front Page"
}
<div class="site-shell">
<block name="core/template-part" slug="header" />
<main>
<h1>Welcome</h1>
<block name="core/post-content" />
</main>
</div>
Blockstudio compila el origen con el mismo analizador que usan las páginas y los patrones y, después, expone el resultado a WordPress como una plantilla o parte de plantilla normal del Editor del sitio. El Editor del sitio muestra la plantilla, el frontend puede renderizarla y WordPress sigue siendo responsable de las personalizaciones.
Este último punto es importante. Las plantillas basadas en archivos son la alternativa de origen. Si un usuario guarda una plantilla en el Editor del sitio, WordPress crea la personalización habitual en la base de datos de wp_template o wp_template_part, y esa versión prevalece. Restablezca la personalización y volverá a mostrarse la versión más reciente del archivo de origen.
Despliegue incremental de páginas
En la versión 7.5, las páginas basadas en archivos incorporaron una API de conciliación para el despliegue. Desde 7.6.2, esos métodos explícitos de API y wp bs pages sync son los únicos puntos de entrada de sincronización; las solicitudes normales nunca aplican cambios de origen:
$report = Blockstudio\Pages::reconcile([
'authoritative' => true,
'plan_valid' => true,
'source' => [
'commit' => $commit,
'dirtyHash' => $dirtyHash,
],
]);
El proceso detecta el inventario completo de páginas deseado, compara el contenido y las huellas digitales del motor de sincronización e informa de las páginas creadas, actualizadas, sin cambios, eliminadas y fallidas. Las páginas con huellas digitales idénticas no generan escrituras en las entradas ni en sus metadatos. Las páginas gestionadas que faltan solo se eliminan después de completar el descubrimiento sin errores.
La conciliación devuelve una identidad de origen determinista, pero no marca el despliegue como exitoso. Las herramientas de despliegue guardan esa identidad solo después de activar y verificar los archivos y las rutas correspondientes. El inicio normal de WP-CLI registra los tipos de entrada de colección y las reglas de reescritura almacenados en caché sin descubrir ni sincronizar todas las páginas.
Islas de bloques
La mayoría de los bloques de Blockstudio se renderizan en el servidor. Esto encaja bien con WordPress, pero plantea un problema de caché habitual: un solo bloque personalizado puede dificultar el almacenamiento de toda la página en caché.
Las islas de bloques dividen ese límite a nivel de bloque.
{
"name": "acme/cart-count",
"blockstudio": {
"island": "dynamic"
}
}
Una isla dinámica solo muestra un marcador de posición seguro para la caché en la primera respuesta. Luego, el navegador envía una única solicitud por lotes para todas las islas dinámicas listas de la página, y Blockstudio renderiza esos fragmentos en el contexto real de la solicitud del visitante.
Así, una caché de página completa puede almacenar la estructura de la página mientras el contador del carrito, los controles de la cuenta, los UI sujetos a permisos y otros elementos por usuario se mantienen actualizados.
<div class="cart-count-placeholder">Loading cart...</div>
<div class="cart-count">
<?php echo esc_html(acme_cart_count()); ?>
</div>
Para los bloques que ya muestran HTML seguros para la caché y solo necesitan una señal de montaje en el frontend, use una isla hidratada:
{
"name": "acme/tabs",
"blockstudio": {
"island": "hydrate"
}
}
Las islas hidratadas no generan una solicitud REST. Se renderizan normalmente y reciben un evento blockstudio:island:hydrate en el frontend.
Las islas dinámicas también funcionan con las rutas de renderizado programático:
bs_render_block([
'name' => 'acme/cart-count',
'data' => ['productId' => 42],
]);
Y con las etiquetas de bloques:
<bs:acme-cart-count product-id="42" />
El endpoint tiene un alcance deliberadamente limitado. Solo renderiza bloques Blockstudio registrados que son dinámicos y se han marcado explícitamente como islas dinámicas. Los atributos se filtran según el esquema del bloque y la lista de atributos permitidos de la isla, y cada marcador lleva una firma generada por el sitio WordPress que atiende la solicitud.
Almacenamiento en base de datos Storh
La capa de base de datos de Blockstudio ya admite tablas, SQLite, JSONC, metadatos de entradas y tipos de contenido personalizados. La versión 7.5 incorpora storage: "storh" para proyectos que buscan un almacén basado en archivos con escrituras simultáneas más seguras e índices derivados del esquema, pero no quieren confirmar registros activos junto a los archivos de origen de los bloques.
return [
'storage' => 'storh',
'fields' => [
'title' => ['type' => 'string', 'required' => true],
'status' => ['type' => 'string'],
'count' => ['type' => 'integer'],
],
];
Los registros de Storh se almacenan en las cargas:
wp-content/uploads/blockstudio/db/my-theme-my-block/default/
El API público no cambia. bs.db(), REST y Db::get() siguen devolviendo valores id enteros. Internamente, Blockstudio asigna esos ID a los ID de documento UUIDv7 de Storh, por lo que el código de cliente existente no necesita cambios.
Cada campo declarado en el esquema se indexa para filtros de igualdad; los campos numéricos y similares a fechas reciben índices de rango, y se aplican las indicaciones explícitas de unicidad. Para los proyectos que empezaron con archivos de datos iniciales JSONC, la nueva migración CLI conserva el archivo de origen y escribe un almacén Storh equivalente:
wp bs db migrate my-theme/app subscribers --to=storh
Así, JSONC tiene una función más clara como formato sencillo de datos iniciales y configuración que se puede confirmar en el repositorio, mientras que Storh se convierte en el backend de archivos recomendado para los datos de producción que admiten escritura.
Mejoras del analizador y bsui
La versión 7.5 también completa detalles menores que suelen surgir cuando un proyecto depende más de las plantillas basadas en archivos y de UI agrupado.
La asignación de elementos ahora puede gestionar el caso habitual de un párrafo de texto enriquecido sin un generador personalizado. Si <p> se asigna a un bloque no básico registrado Blockstudio con un atributo de texto enriquecido content, el texto interno simple se copia en ese atributo. Las etiquetas anidadas y los elementos secundarios asignados siguen analizándose como bloques internos.
InnerBlocks admite allowedBlocks tokenizado en plantillas:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Los tokens admitidos son namespace/*, category:<slug> y @theme. Se expanden en el servidor antes de que el editor reciba la plantilla, por lo que la ruta de renderizado del frontend no cambia.
Los insertados programáticos también son más predecibles. bs_render_block() y bs_block() ahora renderizan los bloques insertados como HTML resueltos por el frontend, incluso si se llaman desde la vista previa del editor de otro bloque. Así, los bloques anidados no filtran pseudo componentes sin procesar <RichText /> ni <InnerBlocks /> en el marcado de la vista previa.
Para UI agrupado, bsui/button ahora admite un atributo icon y iconPosition. Los estilos en línea bsui/* agrupados se emiten en una capa de cascada @layer bsui, y las variantes de botones se pueden ampliar con blockstudio/ui/button/variants-style y el filtro existente blockstudio/blocks/attributes.
Las etiquetas de bloques también admiten más combinaciones. Un prefijo puede resolverse a través de otro, de modo que <theme-ui-input /> con un prefijo de proyecto theme sobre un prefijo de espacio de nombres ui se resuelve como bsui/input. Las etiquetas con prefijo y alias registradas también se muestran en la salida de las plantillas de bloques, no solo en el contenido de las páginas, por lo que una plantilla puede incluirlas directamente en lugar de llamar a bs_render_block().
Los generadores de bloques personalizados registrados mediante blockstudio/block_tags/builders también participan de forma coherente en el análisis de etiquetas y elementos asignados. Los filtros explícitos del renderizador se ejecutan después y pueden sustituir al generador.
Solicitudes en caliente y exportaciones más rápidas
Las cachés del entorno de ejecución y del editor ahora se guardan de forma predeterminada en wp-content/blockstudio/cache en lugar de en las cargas. La ubicación se puede cambiar mediante cache.path o blockstudio/cache/dir, lo que permite mantener la caché persistente en hosts que bloquean los archivos PHP en las cargas. Las cachés del entorno de ejecución, de recursos del editor y de Tailwind también eliminan automáticamente las entradas obsoletas, para que los proyectos de larga duración no acumulen archivos de caché sin límite en el disco.
Las solicitudes en caliente del frontend ahora hidratan un registro válido del entorno de ejecución antes de crear las fuentes de descubrimiento. Así se omiten el descubrimiento recursivo de fuentes, la creación de bloques, el análisis de campos y los recorridos repetidos del árbol de claves de caché. De forma predeterminada, las solicitudes de producción y preproducción confían durante 20 segundos en una instantánea validada de los archivos observados, mientras que los entornos locales y de desarrollo siguen comprobándolos en cada solicitud.
La creación de una caché fría se realiza una sola vez: una solicitud genera y publica el contenido de forma atómica mientras las solicitudes simultáneas esperan el resultado. De forma predeterminada, Tailwind conserva hasta 1,000 entradas compiladas durante 30 días y reutiliza el estado de construcción en caliente del compilador, por lo que un conjunto de rutas del tamaño de un sitio ya no fuerza el uso repetido de una caché diminuta.
Los exportadores de larga duración pueden llamar a Blockstudio\Batch_Render::reset() entre documentos. Esto borra los contadores, los recursos, las islas, los diseños y la generación de Tailwind asociados a la solicitud, sin reconstruir el descubrimiento. El filtro blockstudio/render/dependencies expone las rutas de plantillas y recursos que usa cada bloque renderizado para crear gráficos de dependencias.
Fiabilidad y compatibilidad
La versión se completa con varias correcciones:
- Las definiciones de campos modificadas mediante
blockstudio/blocks/attributesahora determinan tanto la validación de opciones en el momento del renderizado como el esquema del editor. Los valores tipados de opciones numéricas y booleanas también se resuelven de forma coherente. - Los contenedores de bloques del editor usan las mismas clases generadas que el renderizado del frontend, y Canvas puede copiar las clases configuradas para el cuerpo del frontend mediante el nuevo filtro
blockstudio/editor/canvas/body_class. - Content Sync valida el plan completo de origen antes de realizar escrituras destructivas, limita las operaciones de depuración al conjunto de contenido configurado e informa de los errores al escribir archivos sin avanzar el estado de sincronización de esa entidad.
- Los paquetes Composer agrupados en temas activos o principales enlazados simbólicamente ahora resuelven los recursos del editor desde el URL público del tema.
- Las páginas de archivos con clave conservan los valores de campos Blockstudio gestionados por el editor, migran la estructura de claves anidada anterior durante la sincronización y aceptan cero numérico como clave válida.
- Las islas dinámicas verifican las firmas antes de aplicar filtros de atributos de solicitud, ignoran el contexto de solicitud sin firma, restablecen el contexto de los visitantes autenticados del mismo origen y evitan colisiones de caché entre usuarios anónimos.
- Los endpoints de página sin procesar Markdown ahora respetan la visibilidad de las entradas y la protección con contraseña.
- Los controles del editor gestionan de forma más fiable las condiciones vacías, los valores de selección de casillas para activar o desactivar todo, la actualización asíncrona de opciones, el orden de renderizado dinámico y el estado de RichText o WYSIWYG en repetidores.
Tipos de campo personalizados
Más información sobre los tipos de campo personalizados presentados anteriormente.
¿Por qué usar tipos de campo personalizados?
Blockstudio debe seguir siendo útil desde el primer momento, pero los proyectos reales suelen necesitar controles específicos de su dominio: selectores de tokens de espaciado, funciones de color del sistema de diseño, dimensiones adaptables, fuentes de iconos, selectores de productos o controles editoriales que se asignan a un valor estructurado.
Antes de la versión 7.5, esos proyectos podían combinar varios campos integrados o crear una bifurcación del editor. La versión 7.5 ofrece una opción intermedia compatible: Blockstudio gestiona el ciclo de vida del campo y el proyecto, el control.
add_action('init', function () {
wp_register_script(
'acme-field-dimensions',
get_stylesheet_directory_uri() . '/fields/dimensions.js',
['blockstudio-blocks', 'wp-components', 'wp-element'],
'1.0.0',
true
);
bs_register_field_type('acme/dimensions', [
'attribute' => 'object',
'default' => [],
'editor_script' => 'acme-field-dimensions',
'storage' => [
'type' => 'object',
'rest_schema' => [
'type' => 'object',
'additionalProperties' => ['type' => 'string'],
],
],
]);
});
const { createElement: el } = wp.element;
const { TextControl } = wp.components;
window.blockstudio.registerFieldType('acme/dimensions', {
component(props) {
const value =
props.value &&
typeof props.value === 'object' &&
!Array.isArray(props.value)
? props.value
: {};
const sides = props.sides || ['top', 'right', 'bottom', 'left'];
return el(
'div',
{},
sides.map((side) =>
el(TextControl, {
key: side,
label: side,
value: value[side] || '',
onChange(nextValue) {
props.onChange({
...value,
[side]: nextValue,
});
},
}),
),
);
},
});
Después, el campo se puede usar en block.json como si fuera un campo nativo:
{
"blockstudio": {
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"label": "Margin",
"sides": ["top", "bottom"],
"default": {
"top": "md",
"bottom": "md"
}
}
]
}
}
Valores normales de plantilla
El valor guardado está disponible en PHP, Twig y Blade, como cualquier otro atributo Blockstudio.
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
<?php echo esc_html($a['title'] ?? ''); ?>
</div>
Las mismas rutas de objeto también funcionan en las plantillas de extensiones:
{
"blockstudio": {
"extend": "core/group",
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"set": [
{
"attribute": "class",
"value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
}
]
}
]
}
}
Notas de compatibilidad
Los tipos de campo integrados existentes no cambian. Los grupos de campos reutilizables custom/{name} existentes tampoco. Los nombres de tipos de campo personalizados deben estar en minúsculas y tener un espacio de nombres, por ejemplo acme/dimensions; los espacios de nombres custom/ y blockstudio/ están reservados.
Si PHP registra un tipo de campo pero su script del editor no registra el control correspondiente, Blockstudio conserva el valor guardado y muestra un aviso no editable en el editor. Si un tipo de campo no está registrado en PHP, Blockstudio lo omite de los atributos WordPress generados.
Actualización de mantenimiento de 7.5.1
7.5.1 elimina un aviso de conversión de matriz a cadena que se emitía al preparar valores de selección múltiple para el renderizado. Los valores guardados y renderizados ya eran correctos, pero los registros de depuración podían recibir un aviso por cada renderizado de campo.
La actualización complementaria de blockstudio/phpstan v0.1.7 también reconoce campos anidados en grupos anónimos en PHP, Twig, Blade y las estructuras inferidas de atributos de plantilla. Los proyectos existentes pueden recibir esa corrección del paquete con composer update blockstudio/phpstan.