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

بيانات المنشور الوصفية

بما أن قوالب الكتل ليست سوى ملفات PHP عادية، يمكنك استخدام أي شيفرة PHP تريدها فيها. في محرر المنشورات، تُعرض معاينات الكتل مع المنشور الجاري تحريره بوصفه المتغير العام $post، لذا تعمل هناك أيضًا get_the_ID() وغيرها من الدوال التي تعتمد عليه. أما المحررات التي لا تحتوي على منشور قيد التحرير، مثل محرر الموقع، فلا تتوفر فيها قيمة عامة لـ $post.

يوفر Blockstudio أربع طرق مختلفة للوصول إلى معرّف المنشور الحالي في المحرر والواجهة الأمامية.

PHP

PHP
echo $post_id;
echo $postId;
echo $block['postId'];
echo $b['postId'];

Twig

Twig
{{ post_id }}
{{ postId }}
{{ block.postId }}
{{ b.postId }}

الحصول على البيانات الوصفية للمنشور

تتيح جميع إضافات الحقول المخصصة الشائعة وWordPress نفسه الوصول إلى البيانات الوصفية للمنشور باستخدام معرّف المنشور.

ACF

PHP

PHP
echo get_field('field_name', $post_id);

Twig

Twig
{{ fn('get_field', 'field_name', postId) }}

الصندوق الوصفي

PHP

PHP
echo rwmb_get_value('field_id', null, $post_id);

Twig

Twig
{{ fn('rwmb_get_value', 'field_id', postId) }}

تحديث الكتل

افتراضيًا، لا تُحدّث الكتل عند حفظ منشور أو تحديثه. لذلك قد تظهر بيانات قديمة في المحرر بعد الحفظ. لإصلاح ذلك، يمكنك استخدام المفتاح refreshOn داخل block.json لإخبار Blockstudio بتحديث الكتلة عند حفظ المنشور.

JSON
{
  "name": "blockstudio/native",
  "title": "Native Block",
  "category": "text",
  "icon": "star-filled",
  "description": "Native Blockstudio block.",
  "blockstudio": {
    "refreshOn": [
      "save"
    ]
  }
}