يشرح هذا الدليل كيفية إعداد خيار “محددات التضمين المسموح بها” في Discourse. يُعد هذا الإعداد حاسمًا عند نشر منشورات من موقع خارجي إلى Discourse، أو عند تضمين تعليقات Discourse على موقع خارجي باستخدام JavaScript.
مستوى المستخدم المطلوب: المشرف
يُتطلب معرفة أساسية بـ CSS للاستخدامات المتقدمة
عند نشر منشورات إلى Discourse من موقع خارجي، أو عند تضمين تعليقات Discourse على موقع خارجي، قد تواجه مشاكل في عدم جلب المحتوى الصحيح عند الضغط على زر “عرض المنشور بالكامل”. سيساعدك هذا الدليل في إعداد خيار “محددات التضمين المسموح بها” لحل هذه المشكلة.
فهم المشكلة
عندما يضغط المستخدمون على زر “عرض المنشور بالكامل”، قد لا يقوم Discourse بجلب محتوى المنشور الصحيح من موقعك الخارجي. وهنا يأتي دور إعداد “محددات التضمين المسموح بها”.
تحديد مكان الإعداد
يمكنك العثور على إعداد “محددات التضمين المسموح بها” في مكانين:
- ابحث عن “محددات التضمين المسموح بها” في صفحة إعدادات موقعك.
- انتقل إلى Admin > Customize > Embedding، ثم اختر علامة التبويب Crawlers.
تحديد محددات CSS الصحيحة
للعثور على محددات CSS المناسبة:
- انتقل إلى منشور على موقعك الخارجي قمت بنشره إلى Discourse.
- افتح مستكشف ويب المتصفح الخاص بك وافحص بنية HTML للمنشور.
- حدد عناصر HTML التي تحيط مباشرة بمحتوى المنشور الرئيسي.
على سبيل المثال، في منشور نموذجي على WordPress، غالبًا ما يكون المحتوى داخل div بـ .entry-content ضمن وسوم article. في هذه الحالة، قد تستخدم article .entry-content كمحدد CSS.
إعداد الخيار
لجلب أنواع مختلفة من المحتوى من موقعك الخارجي، قد تحتاج إلى إضافة محددات متعددة. على سبيل المثال:
article .entry-content img, article .entry-content p, article .entry-content ul
يستهدف هذا المثال الصور والفقرات والقوائم غير المرتبة الموجودة داخل محتوى المنشور.
الاختبار واستكشاف الأخطاء
قد يتطلب العثور على المحددات الصحيحة بعض التجربة والخطأ. ضع في اعتبارك:
- يقوم Discourse بتخزين محتوى المنشورات الخارجية مؤقتًا لمدة 10 دقائق، لذا قد لا تكون التغييرات مرئية فورًا.
- لتجاوز ذلك، اختبر باستخدام منشورات متعددة أو امسح ذاكرة التخزين المؤقت في موقع تطوير باستخدام
Rails.cache.clearفي وحدة تحكم Rails.
التعامل مع الصور
إذا كنت تواجه صعوبة في جلب الصور من موقعك الإلكتروني، فتأكد من أن محددات CSS الخاصة بك تتضمن عناصر الصور المناسبة. على سبيل المثال:
article .entry-content img
يستهدف هذا المحدد الصور الموجودة داخل محتوى المنشور.
اعتبارات إضافية
- ينطبق إعداد “محددات التضمين المسموح بها” على المنشورات المنشورة عبر API والمنشورات المسترجعة باستخدام سكريبت تضمين Discourse.
- قد تحتاج إلى تعديل المحددات بناءً على بنية موقعك المحدد وأنواع المحتوى.
- تذكر حفظ التغييرات بعد تحديث الإعداد.


