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