Перейти до вмісту

Додавайте поля до будь-якого блоку

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

Власні поля без шаблонів

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

Blockstudio застосовує вихідні дані за допомогою обробника тегів WordPress HTML. Без шаблонів і функцій зворотного виклику для рендерингу.

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 автоматично застосовує вихідні дані.

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