Λογική συνθηκών
Τα πεδία μπορούν να εμφανίζονται ή να αποκρύπτονται ανάλογα με τις συνθήκες.
Τελεστές
Υπάρχουν 8 διαφορετικοί τελεστές που μπορείτε να χρησιμοποιήσετε:
| Τελεστής | Περιγραφή |
|---|---|
== |
Οι τιμές είναι ίσες |
!= |
Οι τιμές δεν είναι ίσες |
includes |
Η τιμή περιλαμβάνεται στην τιμή αναφοράς |
!includes |
Η τιμή δεν περιλαμβάνεται στην τιμή αναφοράς |
empty |
Η τιμή είναι κενή |
!empty |
Η τιμή δεν είναι κενή |
< |
Η τιμή είναι μικρότερη από την τιμή αναφοράς |
> |
Η τιμή είναι μεγαλύτερη από την τιμή αναφοράς |
<= |
Η τιμή είναι μικρότερη ή ίση με την τιμή αναφοράς |
>= |
Η τιμή είναι μεγαλύτερη ή ίση με την τιμή αναφοράς |
Καθολικές συνθήκες
Από προεπιλογή, το Blockstudio περιλαμβάνει 4 καθολικές συνθήκες: τύπος άρθρου, ID άρθρου, ρόλος χρήστη και 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"
}
]
]
}
]
}
}
Στο παραπάνω παράδειγμα, το χαρακτηριστικό text θα εμφανίζεται στον επεξεργαστή μόνο αν το ID άρθρου είναι 1386 ΚΑΙ ο τύπος άρθρου είναι post.
Σημειώστε ότι για τα κλειδιά τύπου χρησιμοποιείται η σύμβαση camelCase: postType, postId, userRole, userId.
Συνθήκες OR
Για να δημιουργήσετε συνθήκες OR, μετακινήστε κάθε ομάδα συνθηκών στον δικό της πίνακα:
{
"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"
}
]
]
}
]
}
}
Το χαρακτηριστικό text θα εμφανίζεται αν (το ID άρθρου είναι 1386 ΚΑΙ ο τύπος άρθρου είναι post) Ή (ο τύπος άρθρου είναι jobs).
Προσαρμοσμένες συνθήκες
Μπορείτε να προσθέσετε προσαρμοσμένες συνθήκες με το φίλτρο blockstudio/blocks/conditions.
Το φίλτρο εκτελείται στο PHP κατά τη φόρτωση του επεξεργαστή και επιστρέφει μία τιμή για κάθε
τύπο συνθήκης. Οι συνθήκες αξιολογούνται στον επεξεργαστή, ο οποίος συγκρίνει αυτή την τιμή με το
value της συνθήκης χρησιμοποιώντας τον τελεστή.
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;
});
Επιστρέψτε μια μη κενή συμβολοσειρά για κάθε κατάσταση. Ένας τύπος συνθήκης με κενή ή τιμή που λείπει παραλείπεται, οπότε το πεδίο παραμένει ορατό.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Συνθήκες μπλοκ
Μπορείτε να ορίσετε συνθήκες που εξαρτώνται από άλλα χαρακτηριστικά. Αντί να ορίσετε ένα κλειδί type, χρησιμοποιήστε το id του χαρακτηριστικού που θέλετε να ελέγξετε:
{
"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
}
]
]
}
]
}
}
Μπορείτε να συνδυάσετε καθολικές συνθήκες με συνθήκες μπλοκ, όπως απαιτείται.
Πλαίσιο επαναλήπτη
Από προεπιλογή, οι συνθήκες για χαρακτηριστικά μέσα σε επαναλήπτες εξαρτώνται από τα χαρακτηριστικά του στοιχείου που επαναλαμβάνεται εκείνη τη στιγμή.
{
"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 χαρακτηριστικών αφορούν το τρέχον στοιχείο του επαναλήπτη, το χαρακτηριστικό text μέσα στον επαναλήπτη θα εμφανίζεται μόνο αν η εναλλαγή μέσα στον επαναλήπτη έχει οριστεί σε true.
Για να ελέγξετε την εναλλαγή έξω από τον επαναλήπτη, προσθέστε το "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"
}
]
]
}
]
}
]
}
}