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

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

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

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

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

[Основы расширений](https://blockstudio.dev/ru/docs/extensions/)

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` записывает каждое значение через пробел вместо того, чтобы сохранять только последнее.

[Свойство set](https://blockstudio.dev/ru/docs/extensions/#attributes)

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`, применяя те же точные совпадения и шаблоны с подстановочными знаками. Исключённый блок не получает ни поля, ни их вывод.

[Выбор целевых блоков](https://blockstudio.dev/ru/docs/extensions/)

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

[Получить Plus](https://blockstudio.dev/ru/plus/)
