 |
ملخص | يتيح لك استيراد المحتوى تلقائيًا من تغذيات RSS/ATOM إلى موقع Discourse الخاص بك كمواضيع |
 |
دليل التثبيت | هذا المكوّن الإضافي مدمج مع Discourse core. لا حاجة لتثبيت المكوّن الإضافي بشكل منفصل. |
تغطي هذه الوثائق كيفية تكوين واستخدام مكوّن استطلاع RSS لاستيراد المحتوى تلقائيًا من تغذيات RSS إلى مجتمع Discourse الخاص بك كمواضيع.
تكوين تغذيات RSS
لتفعيل المكوّن الإضافي، انتقل إلى Admins → Installed plugins، ابحث عن مكوّن RSS Polling، وقم بتبديل المفتاح إلى وضع التشغيل.
بمجرد التفعيل، انقر على Settings ثم زر Add feed لتكوين تغذيتك الأولى.
ستحتاج إلى إضافة المعلومات التالية:
- رابط التغذية: رابط تغذية RSS أو Atom المراد استيراده.
- فلتر الفئة (اختياري): يحدد عناصر التغذية التي سيتم استيرادها بناءً على بيانات الفئة الخاصة بالعنصر. سيتم استيراد العناصر التي تطابق الفئة في التغذية القيمة التي تدخلها فقط إلى Discourse. على سبيل المثال، إذا كانت التغذية تتضمن عناصر موسومة بعدة فئات، يمكنك إدخال مصطلح فئة محدد لاستيراد تلك العناصر فقط.
- المؤلف: مستخدم Discourse موجود سيتم إدراجه كمؤلف لجميع المواضيع المستوردة من هذه التغذية.
- الفئة: فئة Discourse التي سيتم نشر المواضيع المستوردة فيها.
- الوسوم: واحد أو أكثر من الوسوم التي سيتم تطبيقها على جميع المواضيع من هذه التغذية.
انقر على Save لإضافة التغذية.
🎥 مثال شائع: تغذيات YouTube
استيراد قائمة تشغيل YouTube
استخدم نقطة نهاية تغذية RSS الخاصة بـ YouTube لقوائم التشغيل:
https://www.youtube.com/feeds/videos.xml?playlist_id=<PLAYLIST-ID>
حيث <PLAYLIST-ID> هو الرمز الموجود في رابط قائمة التشغيل. على سبيل المثال، بناءً على رابط قائمة التشغيل هذا:
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
رابط التغذية الصحيح هو:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
استيراد قناة YouTube
استخدم تنسيق تغذية RSS للقناة:
https://www.youtube.com/feeds/videos.xml?channel_id=<CHANNEL-ID>
يمكنك العثور على channel_id في YouTube تحت إعدادات متقدمة للقناة.
استخدام رابط القناة القياسي، رابط اسم المستخدم، أو رابط القناة المخصص مباشرة لن يعمل. يتطلب مكوّن استطلاع RSS تنسيق رابط التغذية الصريح لـ
channel_id.
اختبار التغذية
قبل حفظ تغذية جديدة أو معدلة، انقر على Test feed لجلب وتحليل التغذية دون استيراد أي شيء. سترى:
- ملخص عدد العناصر التي سيتم استيرادها، أو التي تم استيرادها بالفعل، أو التي سيتم تخطيها.
- تفصيل سطر بسطر للعناصر الأولى في التغذية، مع شرح بلغة بسيطة لسبب استيرادها أو تخطيها.
هذا مفيد للتحقق من تكوينك — خاصة فلترة الفئة — قبل أن يؤثر على مجتمعك.
الاستطلاعات الأخيرة
في صفحة تعديل أي تغذية موجودة، يعرض قسم Recent polls آخر محاولات الاستطلاع. تعرض كل محاولة أعداد العناصر المستوردة، والمحدثة، والمُتخطاة، والمُفشلَة. يمكنك توسيع أي محاولة لرؤية تفاصيل كل عنصر، بما في ذلك الروابط إلى المواضيع التي تم إنشاؤها أو تحديثها.
عند النقر على Poll now، تظهر النتائج في الوقت الفعلي دون تحديث الصفحة.
الإعدادات
ترتبط علامة Settings بإعدادات الموقع ذات الصلة لاستطلاع RSS.
| الاسم | الوصف |
|---|---|
rss polling feed request timeout |
المدة (بالثواني) التي تنتظرها قبل التخلي عن طلب التغذية البطيء. الافتراضي 30 ثانية. |
rss polling verbose logging |
تفعيل تسجيل مفصل لكل عنصر في كل محاولة استطلاع. معطل افتراضيًا؛ مفيد لاستكشاف الأخطاء وإصلاحها. |
rss polling use pubdate |
استخدام تاريخ النشر الأصلي من عنصر التغذية كتاريخ للموضوع، بدلاً من تاريخ الاستيراد. |
rss polling update tags |
تحديث وسوم الموضوع عند تحديث الموضوع؛ عند تعطيله، يجلب الوسوم الأولية فقط. |
التحكم في رؤية الموضوع
منع المواضيع من أن تكون غير مدرجة
بشكل افتراضي، تكون المواضيع المضمنة غير مدرجة حتى تتلقى ردًا. لمنع المواضيع المستوردة من RSS من أن تكون غير مدرجة:
- انتقل إلى Admin → All site settings.
- ابحث عن
embed unlisted. - عطّل هذا الإعداد.
عرض محتوى المنشور الكامل
إذا كان إعداد embed truncate مفعلاً (الافتراضي)، فإن مواضيع التغذية ستعرض مقتطفًا فقط. لعرض المحتوى الكامل:
- انتقل إلى Admin → All site settings.
- ابحث عن
embed truncate. - عطّل هذا الإعداد.
إذا لم يتم عرض محتوى المنشور الكامل بشكل صحيح، قم بتكوين إعداد embed whitelist selector لتحديد عناصر HTML التي يجب استيرادها.
المشكلات الشائعة
التغذية لا تتحدث
- تأكد من صحة رابط التغذية وإتاحته للجمهور.
- تحقق من أن
rss polling frequencyغير مضبوط مرتفعًا جدًا. - تحقق من وجود عناصر جديدة في التغذية منذ آخر استطلاع.
- استخدم زر Test feed للتحقق مما يراه المكوّن الإضافي في التغذية دون تنفيذ استطلاع كامل.
- فعّل
rss polling verbose loggingللحصول على تفاصيل أكثر حول ما يحدث أثناء كل استطلاع.
إنشاء المواضيع بتواريخ خاطئة
فعّل إعداد rss polling use pubdate لاستخدام تاريخ النشر الأصلي من عنصر التغذية بدلاً من تاريخ الاستيراد.
يتم استيراد كل رابط تغذية مرة واحدة فقط
حذف وإعادة إضافة نفس رابط التغذية لن يعيد استيراد العناصر التي تمت معالجتها سابقًا. يتم استيراد كل عنصر RSS مرة واحدة فقط.