Atributų filtravimas
Blockstudio pateikia du būdus bloko atributams filtruoti.
Atributų aprašai
blockstudio/blocks/attributes filtruoja kiekvieno lauko aprašą, o Blockstudio sukuria ir užregistruoja bloką. Naudokite jį redaktoriaus valdikliams, numatytosioms reikšmėms, sąlygoms, parinktims ir aprašui, pagal kurį atvaizduojant tikrinamos reikšmės, koreguoti.
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);
Aukščiau pateiktas kodas nustato numatytąją lineNumbers reikšmę į true ir paslepia lauką, nebent language nustatyta į css.
Kiekvieno iškvietimo metu funkcijai perduodamas vieno lauko aprašas, įskaitant įdėtus grupės ir kartotuvo laukus. Ji vykdoma registruojant bloką, o ne kiekvieną kartą atvaizduojant svetainės dalį.
Filtruoti parinkčių aprašai taip pat naudojami atvaizduojamų atributų žemėlapyje. Pavyzdžiui, prie select, radio arba checkbox lauko pridėta parinktis pasiekiama redaktoriuje ir lieka tinkama, kai Blockstudio nustato išsaugotą šablono reikšmę:
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);
Atvaizduojamos reikšmės
blockstudio/blocks/attributes/render filtruoja vieno lauko išspręstą reikšmę prieš pat perduodant ją bloko šablonui. Jis vykdomas kiekvienam laukui, todėl atgalinio iškvietimo funkcija gauna reikšmę, lauko raktą ir bloko duomenis.
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);
Pirmiau pateiktas pavyzdys pakeičia bet kokią redaktoriuje laukui lineNumbers išsaugotą reikšmę.
Užregistruokite atgalinio iškvietimo funkciją su trimis priimamais argumentais (paskutinis argumentas, perduodamas per add_filter), kitaip WordPress perduoda tik reikšmę.
$value: išspręsta lauko reikšmė tokiu formatu, kokiu šablonas ją gauna kaip$a[$key]. Grąžinkite reikšmę, kurią turėtų gauti šablonas.$key: lauko raktas, naudojamas$a. Kartotuvo eilutėje tai yra eilutėje esančio lauko ID.$block: bloko duomenų masyvas, kurį šablonai gauna kaip$blockarba$b, suid,name,postId,postType,index,indexTotal,contextir salos žymomis. plėtiniams, taikomiems blokui, kuris nėra Blockstudio blokas,$blockturi tikblockstudioįrašą (attributesirdisabled), bename.
Filtras taip pat vykdomas atributams, kurie nėra Blockstudio laukai, pavyzdžiui, className ir anchor, taip pat <id>__size atitikmeniui failų lauke, todėl prieš keisdami reikšmę patikrinkite $key. Grąžinama reikšmė pakeičia tik $key reikšmę; filtras negali pridėti naujų raktų prie $a.
Naudokite aprašo filtrą lauko konfigūracijai keisti, o atvaizdavimo filtrą – šablono reikšmėms apskaičiuoti arba pakeisti konkrečios užklausos metu.
Kai reikšmės nuskaitomos, o ne atvaizduojamos, per bs_block_values(), šis filtras gauna tik bloko pavadinimą lauke $block.
Naudojant šią pagalbinę funkciją, atvaizdavimo skaitikliai ir kiti tik atvaizdavimo metu kuriami metaduomenys nesukuriami.