يشرح هذا الدليل كيفية تكوين oneboxes واستكشاف الأخطاء وإصلاحها في Discourse. ويغطي إعدادات المسؤول، وكيفية عمل oneboxes، وخطوات حل المشكلات الشائعة.
مستوى المستخدم المطلوب: مسؤول
تعد Oneboxes معاينات روابط غنية يمكن للمستخدمين إنشاؤها في مشاركاتهم. بينما يمكن للمستخدمين إنشاء هذه المعاينات بسهولة، فإن مسؤولي الموقع لديهم ضوابط إضافية وقد يحتاجون إلى استكشاف الأخطاء وإصلاحها عندما لا تتم معاينة الروابط كما هو متوقع.
تكوين المسؤول
لإدارة إعدادات onebox:
- انتقل إلى لوحة تحكم المسؤول
- انتقل إلى قسم إعدادات الموقع
- ابحث عن “onebox”
سترى قائمة بالإعدادات المتعلقة بـ onebox:
تشمل بعض الإعدادات البارزة ما يلي:
post onebox maxlength: يتحكم في كمية النص المتضمنة في oneboxenable inline onebox on all domains: يتيح oneboxes المضمنة، ويحول عناوين URL العادية إلى عناوين مرتبطة (على سبيل المثال،https://en.wikipedia.org/wiki/Fun_(band)يصبح “Fun (band) - Wikipedia”)blocked onebox domains: يسمح لك بتعطيل oneboxes لنطاقات معينة
كيف تعمل Oneboxes
عند تضمين رابط في منشور، يزور Discourse صفحة الوجهة ويبحث عن علامات Open Graph أو oEmbed، بما في ذلك:
- عنوان الموقع
- العنوان
- الصورة المميزة
- أيقونة الموقع (أو favicon)
- الوصف (إلزامي)
- سعر المنتج (إذا كان ذا صلة)
يتطلب Discourse وجود علامة الوصف وأن تحتوي على نص كافٍ لتلخيص الصفحة. بدون هذا، لن يتم عرض الرابط المستهدف كـ onebox.
إليك مثال على onebox لـ \u003chttps://discourse.org\u003e يعرض عنوان الموقع، والصورة المميزة، والأيقونة، والوصف:
استكشاف الأخطاء وإصلاحها
إذا لم تعمل oneboxes كما هو متوقع، جرب هذه الخطوات:
-
اختبر الموقع باستخدام iFramely:
- الصق الرابط وتحقق مما إذا كان يستخدم علامات meta الصحيحة لـ OpenGraph أو oEmbed
- تأكد من وجود نص الوصف وأنه كافٍ
-
تحقق مما إذا كان طلب onebox محظورًا:
- قد تحظر بعض المضيفات وكلاء المستخدم “غير المعروفين”
- تحقق من أن موقع الويب المستهدف لا يحظر وكيل المستخدم الخاص بـ Discourse
-
بالنسبة للروابط الداخلية التي لا تظهر كـ oneboxes:
- تأكد من أن الرابط ليس في فئة آمنة
- تعرض الروابط الداخلية oneboxes فقط في الفئات العامة أو داخل نفس الفئة لأسباب أمنية
من وحدة تحكم rails، يمكنك إلغاء صلاحية / جلب oneboxes بشكل صريح عن طريق استدعاء الطرق أثناء الاختبار عن طريق القيام بما يلي:
[1] pry(main)> Oneboxer.invalidate(url)
=> 0
[2] pry(main)> Oneboxer.onebox(url)
=> "<aside class=\"onebox …(elided)"
[3] pry(main)> InlineOneboxer.invalidate(url)
=> 0
[4] pry(main)> InlineOneboxer.onebox(url)
=> "<aside class=\"onebox …(elided)"