 |
ملخص | يتيح لك استيراد المحتوى تلقائيًا من خلاصات RSS/ATOM إلى موقع Discourse الخاص بك كمواضيع |
 |
دليل التثبيت | هذه الإضافة مدمجة مع نواة Discourse. لا حاجة لتثبيت الإضافة بشكل منفصل. |
يشرح هذا الدليل كيفية إعداد واستخدام إضافة RSS Polling لاستيراد المحتوى تلقائيًا من خلاصات RSS/ATOM إلى موقع Discourse الخاص بك كمواضيع.
مستوى المستخدم المطلوب: مدير
ملخص
سيغطي هذا التوثيق تمكين إضافة RSS Polling، وإعداد عناوين الخلاصات، وإدارة الإعدادات، واستكشاف الأخطاء الشائعة وحلها. ستتعلم كيفية إعداد الخلاصات للنشر في فئات محددة، وتعيين المؤلفين، والتحكم في كيفية ظهور المحتوى على موقعك.
تمكين إضافة RSS Polling
المواقع المستضافة ذاتيًا
انتقل إلى لوحة التحكم الخاصة بك في Admin > Plugins وابحث عن إضافة RSS Polling. قم بتمكينها باستخدام مفتاح التبديل:
المواقع المستضافة بواسطة Discourse
إذا كان موقعك مستضافًا بواسطة Discourse، فتواصل مع فريق الدعم لطلب تفعيل إضافة RSS Polling. الإضافة متاحة في جميع خطط الاستضافة.
إعداد خلاصات RSS
بمجرد تمكين الإضافة، قم بالوصول إلى صفحة إعدادات RSS Polling عن طريق زيارة Admin > Plugin > RSS Polling مباشرة، أو عن طريق التنقل إلى /admin/plugins واختيار “RSS Polling” من قائمة الشريط الجانبي.
إضافة خلاصة RSS جديدة
- أدخل عنوان URL لخلاصة RSS أو ATOM في حقل “عنوان الخلاصة”
- اختر مستخدمًا موجودًا من موقعك كـ “مؤلف” - سيكون هذا المستخدم هو مالك جميع المنشورات المنشأة من الخلاصة
- اختر فئة Discourse سيتم نشر مواضيع الخلاصة فيها
- انقر على زر
حفظ.
اختياري: أضف العلامات التي سيتم تطبيقها على جميع مواضيع هذه الخلاصة و/أو أدخل مرشح فئة الخلاصة لتحديد العناصر التي سيتم استيرادها
مرشح فئة الخلاصة
يتيح لك إعداد مرشح فئة الخلاصة تحديد العناصر التي سيتم نشرها بناءً على بيانات التعريف الخاصة بفئة العنصر. عند إدخال مصطلح فئة في هذا الحقل، سيتم استيراد العناصر التي تطابق هذه الفئة فقط إلى Discourse.
على سبيل المثال، إذا قمت بفحص الخلاصة في https://blog.discourse.org/feed.xml، فسترى أن كل إدخال يحتوي على معلومات الفئة. ستدخل قيمة خاصية term الخاصة بالفئة لفرز فئات محددة.
إعداد خلاصات YouTube
أمثلة شائعة
تُعد YouTube واحدة من أكثر المنصات استخدامًا مع RSS Polling، لكنها أيضًا سهلة الخطأ في الإعداد. فيما يلي تنسيقات عناوين الخلاصات الموصى بها والمدعومة لأكثر حالات استخدام YouTube شيوعًا.
استيراد قائمة تشغيل YouTube
لاستيراد مقاطع فيديو من قائمة تشغيل YouTube، يجب عليك استخدام نقطة نهاية خلاصة RSS الخاصة بقوائم التشغيل على YouTube.
التنسيق الصحيح هو:
https://www.youtube.com/feeds/videos.xml?playlist_id=<PLAYLIST-ID>
حيث <PLAYLIST-ID> هو الرمز الموجود في عنوان URL لقائمة التشغيل.
على سبيل المثال، بالنظر إلى عنوان URL لقائمة التشغيل هذا:
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
سيكون عنوان URL لخلاصة RSS الصحيح هو:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
استيراد قناة YouTube
لاستيراد مقاطع فيديو من قناة YouTube، استخدم تنسيق خلاصة القناة على YouTube:
https://www.youtube.com/feeds/videos.xml?channel_id=YOUR_CHANNEL_ID
يمكنك العثور على channel_id على YouTube تحت الإعدادات المتقدمة للقناة.
لن يعمل استخدام عنوان URL للقناة، أو عنوان URL لاسم المستخدم، أو عنوان URL مخصص للقناة مباشرة. تتطلب إضافة RSS Polling عنوان URL للخلاصة مع
channel_idالصريح.
أخطاء شائعة يجب تجنبها
- استخدام عناوين صفحات YouTube القياسية بدلاً من عناوين خلاصات RSS
- استخدام عناوين قوائم التشغيل أو القنوات دون استخراج المعرف الصحيح
- خلط معلمات قائمة التشغيل والقناة في نفس عنوان URL للخلاصة
إذا تم إعداد خلاصة YouTube بشكل خاطئ، فقد تفشل إضافة RSS Polling بصمت أو تتوقف عن استيراد مواضيع جديدة.
إعداد تردد الاستطلاع
يتحكم إعداد موقع rss polling frequency في مدى تكرار فحص Discourse لخلاصات RSS بحثًا عن محتوى جديد. القيمة الافتراضية هي 30 دقيقة، مع حد أدنى مسموح به قدره 10 دقائق وحد أقصى قدره 180 دقيقة (3 ساعات).
المواقع المستضافة ذاتيًا
لتعديل تردد الاستطلاع:
- انتقل إلى
/admin/site_settings - ابحث عن “rss polling frequency”
- اضبط الفاصل الزمني المطلوب بالدقائق
المواقع المستضافة
تواصل مع فريق الدعم لطلب تعديل إعداد موقع rss_polling_frequency.
إدارة إعدادات الخلاصة
تغيير مؤلف الخلاصة
يمكنك تغيير مؤلف جميع المواضيع المرتبطة بخلاصة RSS محددة عن طريق تحديث حقل “المؤلف” في صفحة إعدادات RSS Polling. سيتم تحديث جميع المواضيع الموجودة من هذه الخلاصة تلقائيًا بالمؤلف الجديد. تظهر هذه التغييرات كأحداث تعديل منشور للنظام في سجلات المسؤول.
تغيير فئة الخلاصة أو العلامات
تغيير فئة أو علامات عنوان URL لخلاصة RSS لن يقوم بتحديث المواضيع الموجودة تلقائيًا. ستحتاج إلى:
- استخدام العمليات الجماعية الإدارية لنقل المواضيع الموجودة يدويًا إلى الفئة الجديدة أو تحديث العلامات
- تحديث إعدادات خلاصة RSS بحيث تستخدم المواضيع الجديدة الفئة والعلامات الصحيحة
قيود عنوان URL للخلاصة
سيتم استيراد كل عنوان URL فريد لخلاصة RSS مرة واحدة فقط في Discourse. عند إعداد خلاصة RSS لأول مرة، يقوم Discourse باستيراد الخلاصة بالكامل. حذف وإعادة إضافة نفس عنوان URL للخلاصة لن يتسبب في إعادة استيراد العناصر التي تمت معالجتها سابقًا.
التحكم في ظهور المواضيع
منع المواضيع من أن تكون غير مدرجة
بشكل افتراضي، تكون المواضيع المضمنة غير مدرجة حتى تتلقى ردًا. هذا السلوك لا معنى له للمواضيع المستوردة من RSS. لمنع مواضيع RSS من أن تكون غير مدرجة:
- انتقل إلى
/admin/site_settings - ابحث عن “embed unlisted”
- قم بتعطيل هذا الإعداد
عرض محتوى المنشور بالكامل
إذا كان إعداد موقع embed truncate مفعّلًا (الافتراضي)، فستعرض مواضيع الخلاصة مقتطفًا فقط. يمكن للمستخدمين عرض المحتوى الكامل عن طريق النقر على زر “عرض المنشور بالكامل”.
لعرض المحتوى الكامل دائمًا:
- انتقل إلى Admin > Site Settings
- ابحث عن “embed truncate”
- قم بتعطيل هذا الإعداد
إذا لم يتم عرض محتوى المنشور بالكامل بشكل صحيح، فقم بتكوين إعداد موقع embed whitelist selector لتحديد عناصر HTML التي يجب استيرادها.
مشاكل شائعة وحلولها
عدم تحديث الخلاصة
تحقق من:
- أن عنوان URL لخلاصة RSS صالح ويمكن الوصول إليه
- أن تردد الاستطلاع لم يتم تعيينه مرتفعًا جدًا
- وجود عناصر جديدة بالفعل في خلاصة RSS منذ آخر استطلاع
عدم استجابة واجهة الإضافة
يبلغ بعض المستخدمين عن مشاكل في عدم استجابة واجهة إعداد RSS Polling. غالبًا ما يكون ذلك ناتجًا عن حواجز إعلانية في المتصفح تتداخل مع واجهة المسؤول. حاول:
- تعطيل حواجز الإعلانات لموقع Discourse الخاص بك
- استخدام متصفح مختلف
- تحديث الصفحة بشكل قسري
إنشاء المواضيع بتواريخ خاطئة
بشكل افتراضي، تستخدم مواضيع RSS التاريخ الحالي عند الاستيراد. إذا كنت تريد استخدام تاريخ النشر الأصلي من خلاصة RSS، فقم بتفعيل إعداد rss polling use pubdate.
الأسئلة الشائعة
كم مرة يمكنني استطلاع خلاصات RSS؟
الحد الأدنى لتردد الاستطلاع هو 10 دقائق، والحد الأقصى هو 180 دقيقة (3 ساعات).
هل يمكنني استيراد الردود من خلاصات RSS؟
لا، تقوم إضافة RSS Polling باستيراد عناصر الخلاصة الرئيسية فقط كمواضيع فردية. لا تقوم باستيراد التعليقات أو الردود.
هل سيؤدي حذف وإعادة إضافة خلاصة إلى إنشاء مواضيع مكررة؟
لا، يتم استيراد كل عنصر من عناصر خلاصة RSS مرة واحدة فقط. إعادة إضافة الخلاصة لن تنشئ نسخًا مكررة.
كيف يمكنني تصحيح مشاكل استطلاع RSS؟
حاليًا، تحتوي الإضافة على سجلات محدودة. تحقق من سجلات Discourse الخاصة بك في لوحة Admins > Security > Logs لأي رسائل خطأ تتعلق باستطلاع RSS.