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

Умовна логіка

Поля можна показувати або приховувати залежно від умов.

Оператори

Можна використовувати 8 різних операторів:

Оператор Опис
== Значення рівні
!= Значення не рівні
includes Значення входить до еталонного значення
!includes Значення не входить до еталонного значення
empty Значення порожнє
!empty Значення не порожнє
< Значення менше за еталонне значення
> Значення більше за еталонне значення
<= Значення менше або дорівнює еталонному значенню
>= Значення більше або дорівнює еталонному значенню

Глобальні умови

За замовчуванням Blockstudio має 4 глобальні умови: тип запису, ID запису, роль користувача та ID користувача.

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/native",
  "title": "Native Block",
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message",
        "conditions": [
          [
            {
              "type": "postId",
              "operator": "==",
              "value": "1386"
            },
            {
              "type": "postType",
              "operator": "==",
              "value": "post"
            }
          ]
        ]
      }
    ]
  }
}

У наведеному вище прикладі атрибут text відображатиметься в редакторі, лише якщо ID запису — 1386 І тип запису — post.

Зверніть увагу, що для ключів типів використовується домовленість camelCase: postType, postId, userRole, userId.

Умови АБО

Щоб створити умови або, перемістіть кожну групу умов у власний масив:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message",
        "conditions": [
          [
            {
              "type": "postId",
              "operator": "==",
              "value": "1386"
            },
            {
              "type": "postType",
              "operator": "==",
              "value": "post"
            }
          ],
          [
            {
              "type": "postType",
              "operator": "==",
              "value": "jobs"
            }
          ]
        ]
      }
    ]
  }
}

Текстовий атрибут відображатиметься, якщо (ID запису — 1386 І тип запису — post) АБО (тип запису — jobs).

Користувацькі умови

Власні умови можна додати за допомогою фільтра blockstudio/blocks/conditions. Фільтр виконується в PHP під час завантаження редактора й повертає одне значення для кожного типу умови. Умови перевіряються в редакторі, який порівнює це значення зі значенням value умови за допомогою оператора.

PHP
add_filter('blockstudio/blocks/conditions', function($conditions) {
  // Check if the current user purchased the product.
  $conditions['purchasedProduct'] = user_has_purchased(123) ? 'yes' : 'no';
  return $conditions;
});

Поверніть непорожній рядок для кожного стану. Тип умови з порожнім або відсутнім значенням пропускається, тож поле залишатиметься видимим.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message",
        "conditions": [
          [
            {
              "type": "purchasedProduct",
              "operator": "==",
              "value": "yes"
            }
          ]
        ]
      }
    ]
  }
}

Умови блоку

Можна задати умови, що залежать від інших атрибутів. Замість ключа type використовуйте id атрибута, який потрібно перевірити:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "toggle",
        "id": "copyButton",
        "label": "Copy Button"
      },
      {
        "type": "text",
        "id": "copyButtonText",
        "label": "Copy Button Text",
        "default": "Copy",
        "conditions": [
          [
            {
              "id": "copyButton",
              "operator": "==",
              "value": true
            }
          ]
        ]
      }
    ]
  }
}

За потреби можна поєднувати глобальні умови з умовами блоку.

Контекст повторювача

За замовчуванням умови для атрибутів усередині повторювачів залежать від атрибутів поточного повторюваного елемента.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "toggle",
        "id": "toggle",
        "label": "Toggle"
      },
      {
        "type": "repeater",
        "id": "repeater",
        "label": "Repeater",
        "attributes": [
          {
            "type": "toggle",
            "id": "toggle",
            "label": "Toggle"
          },
          {
            "type": "text",
            "id": "text",
            "label": "Text",
            "conditions": [
              [
                {
                  "id": "toggle",
                  "operator": "==",
                  "value": true
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Оскільки ID атрибутів обмежені поточним елементом повторювача, текстовий атрибут усередині повторювача відображатиметься, лише якщо перемикач усередині повторювача встановлено в true.

Щоб перевірити перемикач поза повторювачем, додайте "context": "main" до умови:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "toggle",
        "id": "toggle",
        "label": "Toggle"
      },
      {
        "type": "repeater",
        "id": "repeater",
        "label": "Repeater",
        "attributes": [
          {
            "type": "text",
            "id": "text",
            "label": "Text",
            "conditions": [
              [
                {
                  "id": "toggle",
                  "operator": "==",
                  "value": true,
                  "context": "main"
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Кулінарна книга шаблонів полів