Перейти к содержимому

Добавляйте поля в любой блок

Чистый JSON. Без шаблонов и функций рендеринга.

Пользовательские поля без шаблонов

Создайте файл JSON, укажите блок с помощью name и определите поля. set сопоставляет значения с классами, стилями, атрибутами данных или любым другим атрибутом HTML.

Blockstudio применяет вывод с помощью WordPress HTML Tag Processor. Без шаблонов и функций рендеринга.

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

Целевой блок любого типа

Расширяйте один блок, список блоков или все блоки в пространстве имен с помощью подстановочного знака.

Свойство set

Сопоставляйте поля с классами, стилями, атрибутами данных или любыми атрибутами HTML.

Условные поля

Показывайте поля в зависимости от других значений, используя логику как у блоков.

Полный набор возможностей

Все типы полей, условная логика, заполнение и свойства.

Расположение в панели инспектора

Размещайте поля на вкладках настроек, стилей или дополнительных параметров.

Сортировка по приоритету

Задавайте порядок нескольких расширений для одного блока.

Без функций рендеринга

HTML Tag Processor применяет вывод автоматически.

JSON Schema

Специальные автодополнение и проверка схем.

Сопоставление значений с HTML с помощью set

set сопоставляет значения с классами, встроенными стилями, атрибутами данных или любыми атрибутами HTML, используя точечную нотацию, например {attributes.fieldId}.

Получайте доступ к значениям вложенных объектов, применяйте их по условию или выводите значение одного поля в несколько атрибутов.

Если поле возвращает несколько значений, set применяется к каждому из них. Классы и стили суммируются; для любого другого атрибута "join": true записывает каждое значение через пробел вместо того, чтобы сохранять только последнее.

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

Для одного блока или тысяч

Укажите одно имя, например "core/paragraph", массив имен или все пространство имен с помощью "core/*".

Несколько расширений JSON могут быть нацелены на один и тот же блок. Приоритет задает их порядок в панели инспектора.

Список exclude верхнего уровня пропускает блоки, соответствующие условию name, применяя те же точные совпадения и шаблоны с подстановочными знаками. Исключённый блок не получает ни поля, ни их вывод.

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

Исключение блоков

Пропускайте отдельные блоки или целые префиксы, которые иначе подошли бы под шаблон с подстановочным знаком.

Объединение значений

Записывайте в один атрибут все выбранные значения поля с несколькими значениями.

Поле атрибутов

Поле атрибутов записывает пары «имя — значение» в блок без заданного правила.

Просмотр из PHP

bs_block_extension_fields() возвращает поля, которые каждое подходящее расширение добавляет в блок, включая основные и сторонние блоки.

Plus

Официальный набор расширений

Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.

  • 500+ шаблонов сайтов
  • Системные инструкции для ИИ
  • Пожизненные обновления
  • Закрытое сообщество Discord