Přejít k obsahu

Podmíněná logika

Pole lze zobrazit nebo skrýt podle podmínek.

Operátory

Lze použít 8 různých operátorů:

Operátor Popis
== Hodnoty jsou stejné
!= Hodnoty se nerovnají
includes Hodnota je obsažena v referenční hodnotě
!includes Hodnota není obsažena v referenční hodnotě
empty Hodnota je prázdná
!empty Hodnota není prázdná
< Hodnota je menší než referenční hodnota
> Hodnota je větší než referenční hodnota
<= Hodnota je menší nebo rovna referenční hodnotě
>= Hodnota je větší nebo rovna referenční hodnotě

Globální podmínky

Ve výchozím nastavení obsahuje Blockstudio 4 globální podmínky: typ příspěvku, ID příspěvku, uživatelská role a ID uživatele.

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

Ve výše uvedeném příkladu se atribut text zobrazí v editoru pouze v případě, že ID příspěvku je 1386 A typ příspěvku je post.

Všimněte si, že pro klíče typů se používá konvence camelCase: postType, postId, userRole, userId.

Podmínky OR

Chcete-li vytvořit podmínky OR, přesuňte každou skupinu podmínek do vlastního pole:

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

Atribut text se zobrazí, pokud (ID příspěvku je 1386 A typ příspěvku je post) NEBO (typ příspěvku je jobs).

Vlastní podmínky

Vlastní podmínky lze přidat pomocí filtru blockstudio/blocks/conditions. Filtr se spouští v PHP při načtení editoru a vrací jednu hodnotu pro každý typ podmínky. Podmínky se vyhodnocují v editoru, který tuto hodnotu porovnává s value podmínky pomocí operátoru.

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;
});

Pro každý stav vraťte neprázdný řetězec. Typ podmínky s prázdnou nebo chybějící hodnotou se přeskočí, takže pole zůstane viditelné.

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

Podmínky bloku

Můžete nastavit podmínky, které závisejí na jiných atributech. Místo klíče type použijte id atributu, podle kterého chcete podmínku ověřit:

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

Globální podmínky můžete podle potřeby kombinovat s podmínkami bloku.

Kontext opakovače

Podmínky atributů uvnitř opakovačů se ve výchozím nastavení řídí atributy aktuálně opakovaného prvku.

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

Protože jsou ID atributů vymezena aktuálním prvkem opakovače, atribut text uvnitř opakovače se zobrazí pouze tehdy, pokud je přepínač uvnitř opakovače nastaven na true.

Chcete-li ověřovat přepínač vně opakovače, přidejte do podmínky "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"
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Kuchařka vzorů polí