Saltar al contenido

Añade campos a cualquier bloque

Solo JSON. Sin plantillas ni funciones de renderizado.

Campos personalizados, cero plantillas

Crea un archivo JSON, selecciona un bloque con name y define campos. set asigna valores a clases, estilos, atributos de datos o cualquier otro atributo HTML.

Blockstudio aplica la salida con el procesador de etiquetas WordPress HTML. Sin plantillas ni funciones de renderizado.

extend-animation.json
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "allowNull": "None",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ],
        "set": [{
          "attribute": "class",
          "value": "animate-{attributes.animation}"
        }]
      }
    ]
  }
}

Dirígete a cualquier bloque

Extiende un bloque, una lista o todos los bloques de un espacio de nombres.

La propiedad set

Asigna campos a clases, estilos, atributos de datos o cualquier atributo HTML.

Campos condicionales

Muestra campos según otros valores mediante la lógica de los bloques.

Conjunto completo de funciones

Todos los tipos de campo, la lógica condicional, las poblaciones y las propiedades.

Ubicación en el inspector

Coloca campos en las pestañas de ajustes, estilos o avanzadas.

Orden de prioridad

Ordena varias extensiones que apuntan al mismo bloque.

Sin funciones de renderizado

El procesador de etiquetas HTML aplica la salida automáticamente.

JSON Schema

Autocompletado y validación con un esquema específico.

Asigna valores a HTML mediante set

set asigna valores a clases, estilos en línea, atributos de datos o cualquier atributo HTML mediante notación de puntos, como {attributes.fieldId}.

Accede a valores de objetos anidados, aplícalos de forma condicional o asigna un campo a varios atributos.

Un campo que devuelve varios valores aplica set a cada uno. Las clases y los estilos se acumulan; para cualquier otro atributo, "join": true escribe todos los valores separados por espacios, en vez de conservar solo el último.

extend-color.json
{
  "name": "core/heading",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "customColor",
        "type": "select",
        "returnFormat": "both",
        "options": [
          { "value": "#f00", "label": "Red" },
          { "value": "#00f", "label": "Blue" }
        ],
        "set": [
          { "attribute": "style", "value": "color: {attributes.customColor.value}" },
          { "attribute": "data-color", "value": "{attributes.customColor.label}" },
          { "attribute": "class", "value": "has-custom-color" }
        ]
      }
    ]
  }
}

Selecciona un bloque o miles

Selecciona un nombre, como "core/paragraph", una matriz de nombres o un espacio de nombres completo con "core/*".

Varias extensiones de JSON pueden apuntar al mismo bloque. La prioridad determina su orden en el inspector.

Una lista exclude de nivel superior omite los bloques que coincidirían con name, con la misma coincidencia exacta y con comodines. Un bloque excluido no recibe ni los campos ni su salida.

extend-animation.json
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ]
      }
    ]
  }
}

Excluir bloques

Omita bloques individuales o prefijos completos que, de otro modo, coincidirían con un comodín.

Valores unidos

Escriba todos los valores seleccionados de un campo multivalor en un mismo atributo.

Campo de atributos

Un campo de atributos asigna sus pares de nombre y valor al bloque sin una regla de asignación.

Inspeccionar desde PHP

bs_block_extension_fields() devuelve los campos que cada extensión coincidente añade a un bloque, incluidos los bloques del núcleo y de terceros.

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