Φιλτράρισμα χαρακτηριστικών
Το Blockstudio παρέχει δύο μεθόδους για το φιλτράρισμα χαρακτηριστικών block.
Ορισμοί χαρακτηριστικών
Το blockstudio/blocks/attributes φιλτράρει τον ορισμό κάθε πεδίου, ενώ το Blockstudio δημιουργεί και καταχωρίζει ένα block. Χρησιμοποιήστε το για να προσαρμόσετε τα στοιχεία ελέγχου του επεξεργαστή, τις προεπιλογές, τις συνθήκες, τις επιλογές και τον ορισμό που χρησιμοποιείται για την επικύρωση τιμών κατά την απόδοση.
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
if (
($block['name'] ?? '') === 'my-theme/code-block' &&
($attribute['id'] ?? '') === 'lineNumbers'
) {
$attribute['default'] = true;
$attribute['conditions'] = [
[
[
'id' => 'language',
'operator' => '==',
'value' => 'css'
]
]
];
}
return $attribute;
}, 10, 2);
Ο παραπάνω κώδικας ορίζει την προεπιλεγμένη τιμή του lineNumbers σε true και αποκρύπτει το πεδίο, εκτός αν το language οριστεί σε css.
Η συνάρτηση επανάκλησης λαμβάνει έναν ορισμό πεδίου σε κάθε κλήση, συμπεριλαμβανομένων των ένθετων πεδίων ομάδας και επαναλήπτη. Εκτελείται κατά την καταχώριση του block και όχι σε κάθε απόδοση του frontend.
Οι ορισμοί φιλτραρισμένων επιλογών χρησιμοποιούνται επίσης στον χάρτη χαρακτηριστικών απόδοσης. Για παράδειγμα, μια επιλογή που προστίθεται σε πεδίο select, radio ή checkbox είναι διαθέσιμη στον επεξεργαστή και παραμένει έγκυρη όταν το Blockstudio επιλύει την αποθηκευμένη τιμή για ένα πρότυπο:
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
if (
($block['name'] ?? '') === 'bsui/button' &&
($attribute['id'] ?? '') === 'variant'
) {
$attribute['options'][] = [
'label' => 'Brand',
'value' => 'brand',
];
}
return $attribute;
}, 10, 2);
Τιμές απόδοσης
Το blockstudio/blocks/attributes/render φιλτράρει την επιλυμένη τιμή ενός πεδίου αμέσως πριν αυτή περάσει στο πρότυπο block. Εκτελείται μία φορά για κάθε πεδίο, επομένως μια συνάρτηση επανάκλησης λαμβάνει την τιμή, το κλειδί του πεδίου και τα δεδομένα του block.
add_filter('blockstudio/blocks/attributes/render', function($value, $key, $block) {
if (($block['name'] ?? '') === 'my-theme/code-block' && 'lineNumbers' === $key) {
return true;
}
return $value;
}, 10, 3);
Το παραπάνω παράδειγμα παρακάμπτει οποιαδήποτε τιμή έχει αποθηκευτεί στον επεξεργαστή για το lineNumbers.
Καταχωρίστε τη συνάρτηση επανάκλησης με τρία αποδεκτά ορίσματα (το τελευταίο όρισμα του add_filter), διαφορετικά το WordPress περνά μόνο την τιμή.
$value: η επιλυμένη τιμή του πεδίου, στη μορφή που λαμβάνει το πρότυπο ως$a[$key]. Επιστρέψτε την τιμή που πρέπει να λάβει το πρότυπο.$key: το κλειδί του πεδίου, όπως χρησιμοποιείται στο$a. Μέσα σε μια γραμμή επαναλήπτη, είναι το αναγνωριστικό του πεδίου μέσα στη γραμμή.$block: ο πίνακας δεδομένων του μπλοκ που λαμβάνουν τα πρότυπα ως$blockή$b, με ταid,name,postId,postType,index,indexTotal,contextκαι τις σημαίες island. Για επεκτάσεις που εφαρμόζονται σε ένα μπλοκ που δεν είναι μπλοκ Blockstudio, το$blockπεριέχει μόνο την εγγραφήblockstudio(attributesκαιdisabled) και δεν έχειname.
Το φίλτρο εκτελείται επίσης για χαρακτηριστικά που δεν είναι πεδία Blockstudio, όπως τα className και anchor, καθώς και για το συνοδευτικό <id>__size ενός πεδίου αρχείων, επομένως συγκρίνετε το $key πριν αλλάξετε μια τιμή. Η τιμή επιστροφής αντικαθιστά μόνο την τιμή του $key· το φίλτρο δεν μπορεί να προσθέσει νέα κλειδιά στο $a.
Χρησιμοποιήστε το φίλτρο ορισμού όταν αλλάζετε τη διαμόρφωση πεδίων και το φίλτρο απόδοσης όταν υπολογίζετε ή παρακάμπτετε τιμές προτύπων για ένα αίτημα.
Όταν οι τιμές διαβάζονται μέσω του bs_block_values() αντί να αποδίδονται, αυτό το φίλτρο λαμβάνει μόνο το όνομα του block στο $block.
Αυτή η βοηθητική συνάρτηση δεν δημιουργεί μετρητές απόδοσης ούτε άλλα μεταδεδομένα που αφορούν μόνο την απόδοση.