<div data-theme-toc="true"> </div>
يمتلك Discourse القدرة على تضمين التعليقات من موضوع في موقع خارجي باستخدام واجهة برمجة تطبيقات Javascript تنشئ إطار iframe. للحصول على مثال على ذلك عمليًا، تحقق من [مدونة Coding Horror](http://blog.codinghorror.com/welcome-to-the-internet-of-compromised-things/#discourse-comments). يتم تشغيل المدونة عبر [Ghost](https://ghost.org/) ولكن التعليقات مضمّنة من [منتدى Discourse الخاص به](http://discourse.codinghorror.com/t/welcome-to-the-internet-of-compromised-things/3550).
أحد الأمور الهامة التي يجب ملاحظتها في هذا الإعداد هو أنه **يجب على المستخدمين الانتقال إلى منتدىك لنشر الردود**. هذا مقصود، لأننا نعتقد أن واجهة النشر في منتدى Discourse أغنى حاليًا مما يمكننا تضمينه عبر Javascript.
سيوضح هذا الدليل كيفية إعداد تضمين التعليقات على مدونتك أو موقعك الإلكتروني.
### كيف يعمل
في Discourse، يتكون الموضوع من العديد من المشاركات. عندما تقوم *بتضمين* Discourse على موقع آخر، فإنك تربط مستندًا (مقالة مدونة، صفحة HTML، إلخ) بـ *موضوع* واحد. عندما ينشر الأشخاص في ذلك الموضوع، ستظهر تعليقاتهم تلقائيًا على الصفحة التي قمت بتضمينها فيها.
لديك الخيار لتمكين Discourse من إنشاء المواضيع تلقائيًا عند العثور على تضمين جديد، أو يمكنك إنشاء المواضيع بنفسك مسبقًا.
### تكوين Discourse للتضمين (إعداد بسيط)
سيقوم الإعداد التالي بتضمين موجز تعليقات في صفحة على رابط مدونة وهمي هو `http://example.com/blog/entry-123.html`، من منتدى Discourse يعمل على `=DISCOURSE=`.
[wrap=placeholder key=DISCOURSE default=discourse.example.com]النطاق لـ [/wrap]
[wrap=placeholder key=BLOG default=example.com]النطاق لـ [/wrap]
1. قم بزيارة **Admin > Customize > Embedding** (المسؤول > تخصيص > تضمين) في تثبيت Discourse الخاص بك. https://=DISCOURSE=/admin/customize/embedding
2. قم بإنشاء **مضيف قابل للتضمين (Embeddable Host)** واحد على الأقل. يجب أن يكون هذا اسم المضيف (النطاق) حيث تريد تضمين تعليقاتك. في هذه الحالة، المضيف هو `=BLOG=` - لاحظ عدم وجود `http://` والمسار.
- **السماح بالمسار (Path Allowlist)** يسمح لك بتحديد المسارات على المضيف البعيد التي ستقبل التضمين الخاص بك.
- **النشر في الفئة (Post to Category)** - إذا قمت بتوفير فئة جنبًا إلى جنب مع المضيف الذي تدخله، فستنتهي المنشورات المستوردة من ذلك المضيف تلقائيًا في تلك الفئة. يمكن للمضيفين المختلفين النشر في فئات مختلفة.
- **العلامات (Tags)** - يمكنك تعيين علامات ليتم تطبيقها تلقائيًا على المواضيع التي تم إنشاؤها من مضيف معين.
- **مؤلف المنشور (Post Author)** - يمكنك اختياريًا تجاوز مستخدم إنشاء الموضوع على أساس كل مضيف. إذا لم يتم تعيينه، يتم استخدام الإعداد الافتراضي من علامة التبويب **Posts and Topics** (المنشورات والمواضيع).
3. انتقل إلى علامة التبويب **Posts and Topics** (المنشورات والمواضيع) واملأ حقل **Username for topic creation** (اسم المستخدم لإنشاء الموضوع). هذا هو المستخدم الذي سينشئ المواضيع عند العثور على تضمينات جديدة. لنفترض أن منتدى Discourse الخاص بنا يحتوي على مستخدم يسمى eviltrout، لذا فإن القيمة هي `eviltrout`.
4. أدرج HTML التالي في صفحة الويب على `http://=BLOG=/blog/entry-123.html`
```html
<div id='discourse-comments'></div>
<script type="text/javascript">
DiscourseEmbed = {
discourseUrl: 'https://discourse.example.com/',
discourseEmbedUrl: 'http://example.com/blog/entry-123.html',
// className: 'CLASS_NAME',
};
(function() {
var d = document.createElement('script'); d.type = 'text/javascript'; d.async = true;
d.src = DiscourseEmbed.discourseUrl + 'javascripts/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(d);
})();
</script>
الأجزاء القابلة للتهيئة في المقتطف هي في الكائن DiscourseEmbed. discourseUrl هو المسار الكامل إلى قاعدة Discourse الخاص بك، بما في ذلك الشرطة المائلة اللاحقة. discourseEmbedUrl هو المستند الذي يقوم حاليًا بتضمين موجز التعليقات.
إذا قمت بإعداد هذا بشكل صحيح، في المرة الأولى التي تزور فيها http://=BLOG=/blog/entry-123.html، سيحاول تحميل التعليقات الخاصة بمنشور المدونة. نظرًا لعدم وجود أي منها، سيطلب من منتدى Discourse إنشاء موضوع جديد في الخلفية. سيتم إنشاء موضوع جديد بواسطة eviltrout وسيتم الزحف إلى محتويات المنشور الأول من مدونتك وسيتم استخراج النص تلقائيًا.
بمجرد إنشاء الموضوع الجديد، يمكن للمستخدمين النشر فيه، وستظهر تعليقاتهم تلقائيًا في المرة التالية التي تتم فيها زيارة http://=BLOG=/blog/entry-123.html.
className اختياري وسيضيف فئة من اختيارك إلى التضمين حتى تتمكن من تخصيصه باستخدام CSS.
نصيحة: إذا كانت مدونتك تحتوي على مؤلفين متعددين، يمكنك إضافة علامة
<meta name="discourse-username" content="author_username">إلى كل صفحة. عندما يزحف Discourse إلى الصفحة لإنشاء الموضوع، فسيستخدم علامة التعريف هذه لتحديد مؤلف المنشور، متجاوزًا اسم المستخدم الافتراضي المحدد في إعدادات المسؤول.
التضمين في أكثر من صفحة واحدة
في المثال أعلاه، قمنا بتشفير عنوان URL الثابت http://=BLOG=/blog/entry-123.html عند تضمين مقتطف Javascript. هذا عادةً لا يكون كافيًا لأن العديد من المواقع تحتوي على العديد من الصفحات التي يتم إنشاؤها تلقائيًا. على سبيل المثال، في المدونة، يحصل كل إدخال عادةً على صفحته الخاصة. لدعم ذلك، ضع نفس المقتطف على كل صفحة تريد عرض التعليقات فيها، ولكن استبدل القيمة المارة إلى discourseEmbedUrl بعنوان URL للصفحة الحالية. في مدونتي، أستخدم القيمة التالية لـ discourseEmbedUrl: 'http://eviltrout.com<%= current_page.url %>' - مع إنشاء صفحات مدونة جديدة، سيتم إنشاء مواضيع جديدة لها تلقائيًا على Discourse.
تنسيق المحتوى المضمن الخاص بك
لديك القدرة على إضافة ورقة أنماط (stylesheet) لتعليقاتك المضمنة. استخدم قسم Embedded CSS (CSS المضمن) في محرر المظهر في Admin > Customize > Themes > [your theme] > Edit CSS/HTML (المسؤول > تخصيص > السمات > [السمة الخاصة بك] > تعديل CSS/HTML) ويمكنك إضافة ورقة أنماط مخصصة سيتم تقديمها مع تعليقاتك المضمنة. افتراضيًا، نعتقد أن التخطيط يبدو لطيفًا على خلفية بيضاء، ولكن إذا كان موقعك يحتوي على تخطيط فريد، فستحتاج إلى تنسيقه بنفسك.
(اختياري) إضافة موجز للاستقصاء
كما ذكرنا أعلاه، سيقوم Discourse بالزحف تلقائيًا إلى أي موقع يتم تضمينه فيه. ومع ذلك، قد يكون تحليل HTML صعبًا في بعض الأحيان وقد لا يستخرج محتويات منشوراتك بشكل صحيح. تدعم العديد من المدونات ومواقع الويب خلاصات RSS/Atom للنشر، ويمكن لـ Discourse استخدام هذا لاستخراج محتويات منشورات مدونتك بدقة أكبر.
يأتي Discourse مزودًا بـ إضافة استقصاء RSS (مضمنة افتراضيًا). إذا كان لديك خلاص RSS أو Atom مُعدًا على الموقع الذي تقوم بتضمين Discourse فيه، يمكنك تمكين إعداد الموقع rss_polling_enabled وإضافة عنوان URL للخلاصة عبر Admin > Plugins > RSS Polling (المسؤول > الإضافات > استقصاء RSS). بمجرد إضافة عنوان URL للخلاصة، سيقوم Discourse بتحليل الخلاصة ونشر منشوراته في الفئة المناسبة بناءً على المضيفين المسموح بهم الذين تضيفهم إلى إعدادات التضمين الخاصة بك.
(إعداد بديل) الربط بالمواضيع الموجودة
يفضل البعض عدم جعل Discourse ينشئ مواضيع لهم تلقائيًا في منتدياتهم. إنهم يريدون إنشاء المواضيع بأنفسهم، ثم إخبار كود التضمين الخاص بهم ببساطة بالموضوع الذي يريدون ربطه به. يمكنك القيام بذلك عن طريق تغيير كود التضمين الخاص بك قليلاً:
<div id='discourse-comments'></div>
<script type="text/javascript">
window.DiscourseEmbed = {
discourseUrl: 'https://=DISCOURSE=/',
topicId: 12345
};
(function() {
var d = document.createElement('script'); d.type = 'text/javascript'; d.async = true;
d.src = window.DiscourseEmbed.discourseUrl + 'javascripts/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(d);
})();
</script>
الفرق الوحيد هنا هو أننا استبدلنا discourseEmbedUrl بمعرف موضوع من Discourse. إذا قمت بذلك، فلن يتم إنشاء أي موضوع وسيتم عرض التعليقات من هذا الموضوع تلقائيًا.
تحديد سياسة المُحيل (referrer policy)
بسبب التغييرات الأخيرة (سبتمبر 2020) التغييرات على سياسة المُحيل الافتراضية التي يتم تعيينها بواسطة العديد من المتصفحات، يقوم Discourse الآن صراحةً بتعيين سياسة المُحيل لإطار iframe بشكل افتراضي على "no-referrer-when-downgrade". إذا كان موقعك يتطلب سياسة مُحيل أكثر صرامة لأسباب أمنية، فيمكن تعيينها عن طريق إضافة قيمة discourseReferrerPolicy إلى كائن DiscourseEmbed الخاص بسكريبت التضمين. على سبيل المثال:
DiscourseEmbed = { discourseUrl: 'https://forum.example.com/',
discourseEmbedUrl: '<your_posts_canonical_URL>',
discourseReferrerPolicy: 'strict-origin-when-cross-origin'};
الاستعلام البرمجي لتفاصيل التضمين
لدينا نقطة نهاية واجهة برمجة تطبيقات للاستعلام عن تفاصيل التضمين باستخدام embed_url كمعلمة:
curl 'https://meta.discourse.org/embed/info?embed_url=https://blog.discourse.org/2021/04/discourse-team-grows-to-50' -H 'API-KEY: logapikeygoeshere' -H 'API-USERNAME: apiusernamehere'
والاستجابة هي:
{
"topic_id": 187794,
"post_id": 925017,
"topic_slug": "discourse-team-grows-to-50-blog",
"comment_count": 2
}
تضمين التعليقات من موقع خاص
بالنسبة لتثبيتات Discourse الخاصة، إذا كان Discourse على نطاق فرعي من نطاق المدونة، فسيتم عرض التعليقات للمستخدمين الذين قاموا بتسجيل الدخول إلى Discourse. سيرى المستخدمون الذين لم يسجلوا الدخول إلى Discourse رسالة “رفض الاتصال”. إذا كان Discourse والمدونة على نطاقات منفصلة تمامًا، فلن يتم عرض أي تعليقات للمنتديات الخاصة.
استكشاف الأخطاء وإصلاحها
القضية الأكثر شيوعًا التي يواجهها المستخدمون عند تضمين Discourse هي تعيين القيمة الصحيحة للمضيفين القابلين للتضمين الذين أضفتهم. تأكد من التحقق مرتين من أنه نطاق موقعك فقط، ولا يحتوي على شرائط مائلة إضافية أو أحرف غير صالحة.