انتقل إلى المحتوى

تصفية السمات

يوفر Blockstudio طريقتين لتصفية سمات الكتل.

تعريفات السمات

تصفّي blockstudio/blocks/attributes تعريف كل حقل، بينما تنشئ Blockstudio كتلة وتسجلها. استخدمها لضبط عناصر التحكم في المحرر والقيم الافتراضية والشروط والخيارات والتعريف المستخدم للتحقق من القيم أثناء العرض.

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);

يضبط الكود أعلاه القيمة الافتراضية لـ lineNumbers على true ويخفي الحقل ما لم تُضبط language على css.

يتلقى الاستدعاء الراجع تعريفًا واحدًا للحقل في كل مرة، بما في ذلك حقول المجموعات والحقول المكررة المتداخلة. ويُشغَّل أثناء تسجيل الكتلة، وليس مرة واحدة لكل عملية عرض في الواجهة الأمامية.

تُستخدم تعريفات الخيارات التي تمت تصفيتها أيضًا في خريطة سمات العرض. على سبيل المثال، يكون الخيار المضاف إلى حقل select أو radio أو checkbox متاحًا في المحرر ويظل صالحًا عندما يحل Blockstudio القيمة المحفوظة لقالب:

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);

القيم المعروضة

يُرشّح blockstudio/blocks/attributes/render القيمة المحسومة لحقل واحد مباشرةً قبل تمريرها إلى قالب الكتلة. ويُنفذ مرة لكل حقل، لذا يتلقى الاستدعاء الراجع القيمة ومفتاح الحقل وبيانات الكتلة.

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);

يتجاوز المثال أعلاه أي قيمة محفوظة في المحرر لـ lineNumbers. سجّل الاستدعاء الراجع بثلاثة وسائط مقبولة (الوسيط الأخير في add_filter)، وإلا فلن يمرر WordPress سوى القيمة.

يُنفّذ المرشح أيضًا للسمات التي ليست حقول Blockstudio، مثل className وanchor، ولعنصر <id>__size المرافق لحقل الملفات، لذا تحقّق من $key قبل تغيير قيمة. وتستبدل القيمة المُعادة قيمة $key فقط؛ ولا يستطيع المرشح إضافة مفاتيح جديدة إلى $a.

استخدم مرشح التعريف عند تغيير إعدادات الحقل، ومرشح العرض عند حساب قيم القالب لطلب ما أو تجاوزها.

عند قراءة القيم عبر bs_block_values() بدلًا من عرضها، لا يتلقى هذا المرشح سوى اسم الكتلة في $block. لا تنشئ تلك الدالة المساعدة عدّادات العرض وغيرها من البيانات الوصفية الخاصة بالعرض فقط.