Saltar al contenido

Dennis · 7 de febrero de 2026

Introducing Blockstudio 7

Blockstudio 7 ya está aquí. Es la versión más importante en la historia del proyecto: una reescritura completa desde cero de todo el código. Hemos reconstruido cada clase, cada hook y cada línea de código desde cero, con énfasis en PHP moderno, los estándares de programación de WordPress y la facilidad de mantenimiento a largo plazo.

Pero esto no es solo una refactorización. Blockstudio 7 incorpora funciones importantes, como páginas y patrones basados en archivos, un sistema de almacenamiento de metadatos de entradas, integración con SEO y un nuevo analizador de HTML a bloques que lo hace posible. Además, Blockstudio ahora es totalmente gratuito y de código abierto.

Veamos todo lo nuevo.

Gratis y de código abierto

He trabajado en Blockstudio desde 2020 y he publicado decenas de versiones a lo largo de los años. A quienes lo usaban les encantaba, pero siempre fue difícil encontrar un encaje de mercado para un framework comercial de bloques WordPress.

Lo que cambió la situación fueron los LLM. Los asistentes de programación con IA ya son lo bastante buenos para escribir código de bloques, pero necesitan estructuras limpias basadas en archivos. El marcado de bloques de WordPress es desordenado: comentarios HTML serializados con atributos JSON incrustados y mezclados con la estructura del DOM. A las personas les cuesta entenderlo, y a los LLM aún más.

El enfoque centrado en archivos de Blockstudio siempre se diseñó para simplificar las cosas: un block.json y una plantilla PHP en una carpeta. Sin entradas en la base de datos, sin React, sin pasos de compilación. Con v7, esa filosofía va aún más lejos. El analizador de HTML a bloques permite escribir HTML sin formato y convertirlo automáticamente en marcado de bloques válido. Todo permanece en el sistema de archivos. Las únicas escrituras en la base de datos son las sincronizaciones de páginas solicitadas explícitamente mediante PHP API o CLI, y se generan a partir de plantillas de archivos.

Convertir Blockstudio en código abierto es el paso siguiente natural. Cuanto más entrenan los LLM con código de Blockstudio, mejor lo generan. Una base de código abierta, documentación abierta y un archivo de contexto para IA listo para usar con cualquier herramienta: así se crea el mejor entorno para el desarrollo de WordPress asistido por IA.

El plugin completo está disponible en GitHub para que cualquiera lo use, bifurque y mejore. Sin claves de licencia, pagos ni funciones bloqueadas.

Nuevas funciones

Páginas basadas en archivos

Esta es una de las mayores novedades de la versión 7.0. Ahora puede definir páginas completas de WordPress como plantillas de archivos que se sincronizan con la base de datos como contenido de bloques nativo al ejecutar el API o el CLI de sincronización de páginas.

Cree una carpeta con un page.json y un archivo de plantilla:

JSON
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
PHP
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>

Ejecute wp bs pages sync para que Blockstudio analice el HTML y lo convierta en bloques WordPress, y cree o actualice la página en la base de datos.

Combinación de bloques por clave

Al sincronizar las plantillas, normalmente se sobrescribirían las ediciones de los usuarios. El atributo key lo evita al conservar el contenido editado entre sincronizaciones:

HTML
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>

Los bloques con claves coincidentes conservan el contenido editado por el usuario cuando se actualiza la plantilla. Los bloques sin claves se reemplazan por completo.

Vinculaciones de bloques

Como alternativa a las claves, puede usar Block Bindings API del núcleo de WordPress para conectar bloques directamente con los metadatos de las entradas. No es una función de Blockstudio, sino una API nativa de WordPress API. Blockstudio simplemente pasa el atributo metadata al marcado de bloques generado. El contenido se almacena en los metadatos en lugar del marcado de bloques, así que las sincronizaciones de plantillas nunca borran las ediciones de los usuarios. También se pueden consultar los datos mediante WP_Query y están disponibles a través de REST API.

HTML
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>

Ambos métodos se pueden usar en la misma plantilla.

Controles de edición

Las páginas admiten blockEditingMode y templateLock para controlar lo que pueden modificar los usuarios:

JSON
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}

Esto bloquea la estructura de la página y permite que los usuarios editen el texto y los archivos multimedia. Los elementos individuales pueden anular el ajuste de la página con un atributo blockEditingMode en la plantilla.

Asignación a ID de entrada

Use postId para vincular una plantilla de página con una entrada WordPress existente, evitar páginas duplicadas y garantizar que la plantilla siempre actualice la entrada correcta:

JSON
{
  "name": "home",
  "title": "Home",
  "postId": 2
}

Para conocer todos los detalles, consulte la documentación de páginas.

Patrones basados en archivos

Al igual que las páginas, ahora puede definir patrones de bloques como plantillas de archivos. Escriba el patrón en HTML y Blockstudio lo convertirá en marcado de bloques y lo registrará como un patrón de bloques nativo de WordPress. Aparecerá en el insertador de bloques y los usuarios podrán colocarlo donde quieran.

JSON
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
HTML
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>

A diferencia de las páginas, los patrones no crean entradas en la base de datos. Se registran en memoria cada vez que se carga una página. Consulte la documentación de patrones.

Analizador de HTML a bloques

Un nuevo analizador de HTML permite generar páginas y patrones: convierte plantillas estándar de HTML en marcado de bloques WordPress. Procesa automáticamente los bloques contenedores (como grupos y columnas) y los bloques simples (como párrafos y encabezados). El analizador usa una arquitectura de renderizado basada en rasgos, que facilita añadir compatibilidad con otros tipos de bloques mediante el filtro blockstudio/parser/renderers:

PHP
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
    $renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
        $content = $parser->get_inner_html( $element );
        $html    = '<div class="acme-hero">' . $content . '</div>';

        return array(
            'blockName'    => 'acme/hero',
            'attrs'        => $attrs,
            'innerBlocks'  => array(),
            'innerHTML'    => $html,
            'innerContent' => array( $html ),
        );
    };

    return $renderers;
}, 10, 2 );

Una vez registrado, puede usar el bloque en cualquier plantilla de página o patrón:

HTML
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>

Almacenamiento

Ahora los campos pueden guardar sus valores en los metadatos de las entradas o en las opciones del sitio, además de en los atributos de bloques. Esta es una gran novedad:

JSON
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}

Con los valores en los metadatos de las entradas, puede:

  • Consultar entradas por los valores de campo mediante WP_Query y meta_query
  • Acceder a los datos de los campos a través de REST API para instalaciones sin frontend
  • Compartir datos con otros plugins, como herramientas SEO y capas de caché

También puede guardar valores en la tabla de opciones para definir ajustes globales de todo el sitio:

JSON
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}

Consulte la documentación de almacenamiento para ver todos los detalles de API.

Campos personalizados

Ahora es posible compartir definiciones de campos reutilizables entre varios bloques. Defina un conjunto de campos una sola vez y luego haga referencia a él desde cualquier bloque. Así se evitan repeticiones cuando varios bloques comparten la misma estructura de campos.

Cree un field.json en el directorio de blockstudio:

JSON
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}

Luego haga referencia a él desde cualquier bloque con el prefijo custom/:

JSON
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}

La propiedad idStructure añade un prefijo al ID de cada campo, de modo que heading se convierte en hero_heading. También puede sobrescribir propiedades de campos individuales para cada instancia con la clave overrides.

Consulte la documentación de campos personalizados.

Tailwind CSS v4

La compatibilidad con Tailwind se ha reconstruido por completo para v4. En vez de compilar en el cliente con CDN y guardar en disco al guardar la entrada (el método de v6), Blockstudio 7 compila Tailwind en el servidor en cada solicitud del frontend mediante TailwindPHP. Sin Node.js, sin CLI y sin pasos de compilación.

La compilación usa caché basada en candidatos: Blockstudio extrae todos los nombres de clases de CSS del HTML final, los ordena y calcula su hash junto con la configuración CSS, y busca un archivo en caché. Las mismas clases generan el mismo resultado de caché, aunque cambie el HTML circundante (nonces, marcas de tiempo o contenido dinámico).

La configuración usa la sintaxis basada primero en CSS de Tailwind v4. Defina temas personalizados y clases de utilidades directamente en su blockstudio.json o mediante el filtro blockstudio/tailwind/css:

PHP
add_filter('blockstudio/tailwind/css', function ($css) {
  return $css . '
    @theme {
      --color-brand: #4f46e5;
    }

    @layer utilities {
      .container-narrow {
        max-width: 48rem;
        margin-inline: auto;
      }
    }
  ';
});

En el editor de bloques, un script Tailwind CDN incluido proporciona una vista previa en directo mientras escribe. El tipo de campo classes ofrece autocompletado para todas las utilidades de Tailwind. El frontend siempre usa el CSS compilado en el servidor, insertado como etiqueta de estilo en línea antes de </head>.

Consulte la documentación de Tailwind para ver la configuración completa.

API interactivo

Ahora Blockstudio es compatible con Interactivity API de WordPress. Actívelo en su block.json:

JSON
{
  "blockstudio": {
    "interactivity": true
  }
}

Añada directivas data-wp-* a su plantilla:

PHP
<div useBlockProps
     data-wp-interactive="myBlock"
     data-wp-context='{ "isOpen": false }'>
  <button data-wp-on--click="actions.toggle"
          data-wp-bind--aria-expanded="context.isOpen">
    Toggle
  </button>
  <div data-wp-bind--hidden="!context.isOpen">
    This content is toggled by the button.
  </div>
</div>

Y cree un script.js con la lógica de su almacén:

JavaScript
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});

Blockstudio gestiona el importmap, la carga de módulos y el procesamiento de directivas tanto en el frontend como en el editor de bloques. Los bloques que solo usan directivas declarativas con data-wp-context (como data-wp-bind--hidden o data-wp-text) funcionan sin ningún JavaScript. También admite el estado del servidor mediante wp_interactivity_state() en el frontend.

Consulte la documentación de interactividad para ver la configuración completa.

Análisis de contenido de SEO

Los bloques de Blockstudio son dinámicos, por lo que, de forma predeterminada, los plugins de SEO no pueden ver el contenido de sus campos. Blockstudio 7 lo resuelve con integraciones automáticas para Yoast SEO, Rank Math y SEOPress. Los valores de texto de los campos text, textarea, richtext, wysiwyg y link (incluidas las filas anidadas de repetidores) se extraen y se pasan al análisis de contenido de cada plugin. Así, los plugins de SEO pueden analizar correctamente el contenido de sus bloques para medir la densidad de palabras clave, la legibilidad y otras métricas. No hace falta configurar nada.

Filas predeterminadas de repetidores

Los campos repetidores ahora admiten una propiedad default con una matriz de filas rellenadas previamente. Al insertar un bloque, el repetidor se rellena con las filas y los valores especificados, tanto en el editor como en el frontend:

JSON
{
  "id": "features",
  "type": "repeater",
  "label": "Features",
  "default": [
    { "title": "Fast", "icon": "bolt" },
    { "title": "Secure", "icon": "shield" }
  ],
  "attributes": [
    { "id": "title", "type": "text", "label": "Title" },
    { "id": "icon", "type": "text", "label": "Icon" }
  ]
}

La propiedad min también funciona con valores predeterminados a nivel de campo: si un repetidor tiene min: 3 y sus campos internos tienen valores default, las filas generadas automáticamente se rellenan con esos valores predeterminados en lugar de quedar vacías.

Mejoras y correcciones

  • min de repetidores con valores predeterminados de campo: las filas mínimas generadas automáticamente ahora usan valores predeterminados de campo tanto en el frontend como en el editor
  • Estilos del editor de Tailwind: Tailwind CSS compilado ahora se inserta en el iframe del editor de bloques junto con CDN, por lo que las reglas @apply personalizadas y la configuración del tema funcionan en el editor
  • Archivo de contexto para IA: blockstudio-llm.txt se ha reconstruido como un archivo estático a partir de toda la documentación de v7 y de esquemas JSON sin duplicados (~48k tokens), en sustitución de la generación dinámica desde v6
  • Ventana emergente del campo de código: ahora se puede abrir el campo de código en una ventana independiente, con deshacer y rehacer por separado y resaltado de sintaxis JavaScript
  • Compilación en el servidor de Tailwind v4: consulte la sección Tailwind anterior
  • Versión 3 de API: ahora los bloques se muestran correctamente en el editor con iframe, incluidos el editor del sitio y las vistas previas adaptables
  • Notación con puntos para recursos: convención más clara para nombrar los sufijos de archivos de recursos (*.inline.css, *.editor.js, *.scoped.css)
  • Se corrigió una advertencia de bs_render_block() de WP_Block_Supports al usar useBlockProps
  • Se corrigieron los campos condicionales que no respetaban los valores predeterminados al cargar por primera vez
  • Se corrigió la eliminación de los signos de dólar del contenido <RichText /> en el frontend
  • Se corrigió la función populate para que funcione con taxonomías registradas por otros plugins
  • Se corrigió un error de valor nulo de optionsPopulate en contextos WPML

Bajo el capó

Reescritura completa

No se trata de una refactorización ni de una limpieza. Hemos reescrito todas las clases desde cero. El resultado es una base de código más limpia y modular, más fácil de mantener y ampliar.

PHP moderno

Blockstudio 7 requiere PHP 8.2+ y utiliza declaraciones de tipos modernas en todo el código.

Cambios incompatibles

Como actualización de versión principal, la versión 7.0 incluye varios cambios incompatibles. La mayoría cuenta con alternativas compatibles con versiones anteriores, pero conviene revisarlos antes de actualizar. Para consultar la guía completa de migración, vea la documentación de migración de v7.

Los nombres de los hooks ahora usan snake_case

Todos los hooks de PHP han pasado de camelCase a snake_case, de acuerdo con las convenciones del núcleo de WordPress:

PHP
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
    return ['my-stylesheet'];
});

// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
    return ['my-stylesheet'];
});

Los nombres antiguos en camelCase siguen funcionando, pero recomendamos actualizarlos.

El interruptor de campo ahora está desactivado de forma predeterminada

La propiedad switch ahora tiene false como valor predeterminado en lugar de true. En v6, cada campo tenía un interruptor invisible en el borde izquierdo que venía activado. En v7, el interruptor es opcional y usa un icono de ojo visible en la etiqueta del campo. Si dependía del comportamiento predeterminado del interruptor, añada "switch": true a las definiciones de sus campos.

Los nombres de archivos de recursos usan notación con puntos

Los sufijos de los recursos ahora usan puntos en vez de guiones (style.inline.css en lugar de style-inline.css). La notación antigua con guiones sigue funcionando, pero la notación con puntos es la convención recomendada en adelante.

Prefijo de importación de npm

Las importaciones de módulos ES ahora usan npm: en lugar de blockstudio/:

JavaScript
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";

// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";

El prefijo blockstudio/ sigue admitiéndose por compatibilidad con versiones anteriores.

Funciones eliminadas

Área de administración y editor de código. Se han eliminado tanto la página de ajustes de administración de WordPress como el editor de código de bloques integrado. Ahora toda la configuración se realiza mediante filtros blockstudio.json y PHP, por lo que su configuración vive en el control de versiones junto a sus bloques.

El editor de código era útil en versiones anteriores para previsualizar bloques, pero nunca llegó a ofrecer todas las funciones de un entorno de desarrollo real. Durante años, varias funciones del plugin quedaron limitadas porque no se podían ofrecer en el editor independiente. Además, nunca iba a sustituir a un IDE completo. Al eliminarlo, el plugin puede centrarse por completo en el desarrollo basado en archivos.

Clave de licencia. Ya no se necesita. Blockstudio es gratuito y de código abierto.

Biblioteca de bloques. Se ha eliminado la biblioteca integrada «Elementos Blockstudio» (Galería, Carrusel, Comparación de imágenes, Código, Icono). Eran bloques de ejemplo preconstruidos que se incluían con el plugin. Si los usaba, copie las carpetas de bloques de v6 al directorio blockstudio de su tema.

Primeros pasos

Instale Blockstudio 7 y cree su primer bloque en minutos. Consulte la guía de primeros pasos para seguir las instrucciones paso a paso, o la guía de migración de v7 si está actualizando desde v6.

El código fuente completo está en GitHub. Damos la bienvenida a problemas, solicitudes de cambios y comentarios.