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.
{
"$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:
{
"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.
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.
{
"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:
{
"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.
{
"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":
{
"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"
}
]
]
}
]
}
]
}
}