Liigu sisu juurde

Tingimusloogika

Välju saab tingimuste alusel kuvada või peita.

Operaatorid

Kasutada saab 8 eri operaatorit:

Tehe Kirjeldus
== Väärtused on võrdsed
!= Väärtused ei ole võrdsed
includes Väärtus sisaldub võrdlusväärtuses
!includes Väärtus ei sisaldu võrdlusväärtuses
empty Väärtus on tühi
!empty Väärtus ei ole tühi
< Väärtus on võrdlusväärtusest väiksem
> Väärtus on võrdlusväärtusest suurem
<= Väärtus on võrdlusväärtusest väiksem või sellega võrdne
>= Väärtus on võrdlusväärtusest suurem või sellega võrdne

Üldised tingimused

Vaikimisi sisaldab Blockstudio 4 üldist tingimust: postituse tüüp, postituse ID, kasutaja roll ja kasutaja 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"
            }
          ]
        ]
      }
    ]
  }
}

Ülaltoodud näites kuvatakse teksti atribuut redaktoris ainult siis, kui postituse ID on 1386 JA postituse tüüp on post.

Pange tähele, et tüübi võtmete puhul kasutatakse camelCase-vormingut: postType, postId, userRole, userId.

VÕI-tingimused

Või-tingimuste loomiseks paigutage iga tingimuste rühm eraldi massiivi:

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

Teksti atribuut kuvatakse, kui (postituse ID on 1386 JA postituse tüüp on post) VÕI (postituse tüüp on jobs).

Kohandatud tingimused

Kohandatud tingimusi saab lisada filtri blockstudio/blocks/conditions abil. Filter käivitub redaktori laadimisel PHP ja tagastab iga tingimustüübi kohta ühe väärtuse. Tingimusi hinnatakse redaktoris, mis võrdleb seda väärtust tingimuse value väärtusega operaatori abil.

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

Tagastage iga oleku kohta mittetühi string. Tingimustüübid, mille väärtus on tühi või puudub, jäetakse vahele, nii et väli jääb nähtavaks.

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

Ploki tingimused

Saate määrata tingimused, mis sõltuvad teistest atribuutidest. type-võtme määramise asemel kasutage kontrollitava atribuudi id-d:

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

Vajaduse korral saate ühendada üldised tingimused ploki tingimustega.

Kordaja kontekst

Vaikimisi sõltuvad kordajate sees olevate atribuutide tingimused parajasti korratava elemendi atribuutidest.

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

Kuna atribuudi ID-d on seotud parajasti kordatava elemendiga, kuvatakse kordaja sees olev teksti atribuut ainult siis, kui kordaja sees oleva lüliti väärtuseks on true.

Väljaspool kordajat oleva lüliti kontrollimiseks lisage tingimusele "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"
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Väljade mustrite retseptikogu