Block preview: نافذة معاينة الكتلة
Block preview نافذة معاينة تعرض نتيجة عمل الكتلة في الوقت الفعلي. النافذة نفسها موجودة في شاشات إعدادات كتل التوصيات والكتل الديناميكية، وتفتحها بالزر «Open in modal».
لماذا تحتاج إليها
عند إعداد الكتلة (الاستراتيجية، الفلاتر، الجمهور) تريد أن تعرف مباشرةً أي المنتجات ستظهر في نتائجها بهذه الإعدادات. تتيح لك Block preview التحقق من ذلك دون نشر الكتلة على الموقع ودون مغادرة لوحة الإدارة.
علامة التبويب Basic: قائمة المنتجات
تتكون النافذة من ثلاث علامات تبويب: Basic | Explanation | Investigate.
علامة التبويب الأولى هي Basic، وتعرض جدولًا بالمنتجات التي ستظهر في نتائج الكتلة بالإعدادات الحالية:
- تُحمَّل المنتجات تلقائيًا عند التمرير إلى أسفل الجدول.
- يعرض الجدول معاينات للبطاقات (الاسم، الصورة، العلامة، بيانات وصفية مختصرة).
- في كتلة Similar products تُبنى المعاينة على الكتلة المحفوظة، وتظهر على الشاشة الملاحظة «The preview is generated based on the saved block — form changes will be applied after saving». لرؤية نتيجة تعديلاتك، احفظ الكتلة أولًا.
علامة التبويب Explanation: لماذا ظهر المنتج في النتائج
علامة التبويب الثانية هي Explanation، وتجيب عن سؤال «لماذا ظهر هذا المنتج تحديدًا في الكتلة»: تظهر تحت كل بطاقة منتج شارات بأسباب اختياره، مثل «Ordered together» و«Matching attributes» و«In the same section» و«In the popular ranking» و«Viewed» و«Substituted as popular».
الشارات مرتبة حسب معناها: أولًا استبدال النتائج (fallback إلى المنتجات الشائعة)، ثم الاختيار (لماذا المنتج موجود هنا أصلًا)، ثم الترتيب (لماذا يحتل هذا الموضع)، وأخيرًا خفض الترتيب (مثل «Lower — price difference»، أي أن المنتج نُقل إلى موضع أدنى بسبب فرق السعر).
تشرح Explanation النتائج لكل منتج على حدة: ما الذي أدى إلى ظهور بطاقة معينة. أما Investigate فتعرض الصورة للطلب بأكمله: أي قاعدة جمهور طُبّقت، وما التحذيرات التي أصدرها النظام، وهل فُعّل fallback. إذا لم تكن هناك أسباب للاختيار، تعرض علامة التبويب رسالة مثل «No data for explanation»، وهذا طبيعي، على سبيل المثال في حالة المعاينة الفارغة.
علامة التبويب Investigate: التشخيص
علامة التبويب الثالثة هي Investigate، وهي مخصصة لتصحيح الأخطاء. تعرض ما جرى «خلف الكواليس» أثناء تكوين النتائج:
| القسم على الشاشة | المعنى |
|---|---|
| Audience rule applied | قاعدة الجمهور التي طُبّقت على الطلب الحالي. راجع Audience Filter (يفتح في علامة تبويب جديدة). |
| Warnings | رسائل تشخيصية، مثل «مجموعة السمات فارغة» أو «اختار fallback منتجات من خارج الفئة المحددة». |
| Fallback used | مؤشر يبيّن ما إذا كان مسار fallback قد شُغّل (عرض احتياطي للمنتجات الرائجة). |
| Request context | سياق الطلب: ما تلقاه النظام عند بناء المعاينة (معرّف المستخدم، السلة، الفئات المحددة وما إلى ذلك). |
إذا لم تتوفر بيانات لقسم ما، فلا يظهر هذا القسم في علامة التبويب Investigate، وهذا ليس خطأ.
Simulate user (ID): المعاينة نيابةً عن مستخدم
في شاشة إعدادات الكتلة، يحدد قسم Context for preview السياق الذي تُبنى له المعاينة. يختلف الحقل باختلاف نوع الكتلة:
| نوع الكتلة | حقل سياق المعاينة |
|---|---|
| Trending، Recently viewed، Personal recommendations، Repeat purchase | Simulate user (ID) |
| Cart complement، Cart similar | Test cart (product IDs) |
| Wishlist similar | Test wishlist (product IDs) |
| Frequently ordered، Similar products (الوضع التلقائي) | Test product ID |
في الكتل المخصصة حسب المستخدم يكون هذا الحقل Simulate user (ID) (وتُذكر القيمة نفسها في تشخيصات علامة التبويب Investigate باسم simulatedUserId). أدخل معرّف أي مستخدم، فتبني المعاينة النتيجة كما لو أن الطلب جاء منه. يفيد ذلك في:
- التحقق من التوصيات الشخصية (Personal recommendations، Repeat purchase) لعميل محدد؛
- إعادة إنتاج شكوى مثل «الكتلة تعرض لي منتجات غير صحيحة»: أدخل معرّف هذا العميل وشا هد ما سيظهر له.
إذا لم تحدد Simulate user (ID)، تستخدم المعاينة سياقك الإداري، وقد تكون نتائج الكتل المخصصة حسب المستخدم فارغة أو غير ذات صلة.
حق الوصول blocks.preview
يتحكم حق منفصل هو blocks.preview في شجرة الحقوق (يفتح في علامة تبويب جديدة) بالوصول إلى معاينة الكتلة.
يتيح لك ذلك:
- منح دور يحرّر الكتل دون الوصول إلى المعاينة (مثلًا لمديري المحتوى الذين يعملون «على النموذج فقط»).
- إخفاء بيانات حساسة قد تظهر في Investigate (قسم Request context) عن بعض المسؤولين.
امنح blocks.preview لمن يعدّون نتائج الكتل ويتحققون منها. أما مديرو المحتوى فامنحهم إياه فقط إذا كان عليهم رؤية النتائج الفعلية للكتلة قبل النشر.