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