Pereiti prie turinio

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.

PHP
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ę:

PHP
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.

PHP
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 $block arba $b, su id, name, postId, postType, index, indexTotal, context ir salos žymomis. plėtiniams, taikomiems blokui, kuris nėra Blockstudio blokas, $block turi tik blockstudio įrašą (attributes ir disabled), be name.

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.