Pular para o conteúdo

Adicione campos a qualquer bloco

Apenas JSON. Sem templates nem callbacks de renderização.

Campos personalizados, zero templates

Crie um arquivo JSON, direcione um bloco com name e defina os campos. set mapeia valores para classes, estilos, atributos de dados ou qualquer outro atributo HTML.

Blockstudio aplica a saída com o WordPress HTML Tag Processor. Sem templates nem callbacks de renderização.

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}"
        }]
      }
    ]
  }
}

Direcione para qualquer bloco

Estenda um bloco, uma lista ou um curinga de namespace.

A propriedade set

Mapeie campos para classes, estilos, atributos de dados ou qualquer atributo HTML.

Campos condicionais

Mostre campos com base em outros valores usando lógica no estilo de blocos.

Conjunto completo de recursos

Todos os tipos de campo, lógica condicional, populações e propriedades.

Posicionamento do inspetor

Coloque campos nas abas de configurações, estilos ou avançado.

Ordenação por prioridade

Ordene várias extensões direcionadas ao mesmo bloco.

Sem callbacks de renderização

O HTML Tag Processor aplica a saída automaticamente.

JSON Schema

Preenchimento automático e validação com esquema dedicado.

Mapeie valores para HTML com set

set mapeia valores para classes, estilos em linha, atributos de dados ou qualquer atributo HTML usando notação de pontos, como {attributes.fieldId}.

Acesse valores de objetos aninhados, aplique-os condicionalmente ou gere um campo em vários atributos.

Um campo que retorna vários valores aplica set a cada um deles. Classes e estilos são acumulados; para qualquer outro atributo, "join": true grava todos os valores, separados por espaços, em vez de manter apenas o ú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" }
        ]
      }
    ]
  }
}

Direcione um bloco ou milhares

Direcione um nome, como "core/paragraph", uma matriz de nomes ou um namespace inteiro com "core/*".

Várias extensões JSON podem direcionar o mesmo bloco. A prioridade controla a ordem no inspetor.

Uma lista exclude no nível superior ignora os blocos que name corresponderia, usando a mesma correspondência exata e com curingas. Um bloco excluído não recebe os campos nem sua saída.

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

Excluir blocos

Ignore blocos individuais ou prefixos inteiros que, de outra forma, corresponderiam a um curinga.

Valores concatenados

Grave todos os valores selecionados de um campo com vários valores em um único atributo.

Campo de atributos

Um campo de atributos grava seus pares de nome e valor no bloco sem uma regra definida.

Inspecione por meio de PHP

bs_block_extension_fields() retorna os campos que cada extensão correspondente adiciona a um bloco, incluindo os blocos do núcleo e de terceiros.

Plus

O kit oficial de extensões

Modelos premium de site, instruções de sistema para IA e uma comunidade privada Discord. Compra única, atualizações vitalícias.

  • 500+ modelos de sites
  • Instruções de sistema para IA
  • Atualizações vitalícias
  • Comunidade privada de Discord