تخطّ إلى المحتوى
TubePress — مجاني، مستضاف ذاتياً & مُصان باستمرار
استيراد المحتوى

استيراد التغذية (MRSS، RSS، CSV، JSON)

اربط التغذيات الخارجية واسحب مقاطع الفيديو الجديدة تلقائيًا وفق جدول زمني.

استيراد الخلاصات (يُعرف أحيانًا بـ الجالبات) يُبقي مكتبتك تنمو تلقائيًا. تشترك في خلاصة بعيدة مرةً واحدة، ثم تتحقق TubePress منها وفق جدول زمني، وتسحب مقاطع الفيديو الجديدة وتتجاهل ما سبق أن رأته.

يوجد كعلامة تبويب داخل شاشة الاستيراد — افتح /admin/import وانتقل إلى الخلاصات (عنوان URL الخاص بـ /admin/feeds يُعيد التوجيه إليه). على خلاف رفع الملفات لمرة واحدة، تواصل الخلاصة إضافة محتوى لموقعك كلما نشر المصدر المزيد.

ما الذي يفعله استيراد الخلاصات

كل مصدر هو عنوان URL خلاصة مع بعض الإعدادات. وفق جدوله الزمني، تجلب TubePress الخلاصة وتُوحِّد كل إدخال وتُضيف العناصر الجديدة إلى قائمة الانتظار؛ ثم تُحوِّل مرحلة ثانية تلك العناصر المنتظرة إلى مقاطع فيديو. تختار كيفية تخزين الوسائط:

  • تضمين — تخزين رابط المشغِّل. سريع، لا يستهلك مساحة تخزينية، والفيديو يُبثّ من المصدر.
  • تنزيل — جلب الملف الفعلي إلى مساحة التخزين أو CDN الخاص بك وترميزه إلى صيغك المخصصة.

لكل مصدر تُحدِّد أيضًا نوع الفيديو (عادي، مثلي، أو هنتاي) وما إذا كانت مقاطع الفيديو الجديدة تُنشر تلقائيًا أو تُحتجز كمسودات للمراجعة.

صيغ الخلاصات المدعومة

يُدعم أربع صيغ، تُكتشف تلقائيًا بزر اكتشاف ومعاينة:

الصيغةالتعيينملاحظات
MRSSتلقائيMedia RSS — الخيار الأكثر ثراءً؛ تتعيَّن الحقول تلقائيًا.
RSSتلقائيعناصر RSS القياسية.
CSVيدويملف CSV مُقدَّم عبر URL؛ تُعيِّن الأعمدة يدويًا.
JSONيدويمصفوفة JSON مُقدَّمة عبر URL؛ تُعيِّن المفاتيح يدويًا.
تلقائي مقابل يدوي. تُعرَّف MRSS و RSS تلقائيًا. أما CSV و JSON فصيغتان عامتان، لذا تُعيِّن أعمدتيهما مرةً واحدة — راجع تعيين الحقول أدناه.

إضافة مصدر خلاصة

  1. افتح علامة تبويب الخلاصات. انتقل إلى /admin/import، واختر الخلاصات، ثم إضافة مصدر خلاصة.
  2. أدخل عنوان URL الخلاصة. يجب أن يبدأ بـ http:// أو https://. انقر اكتشاف ومعاينة لاكتشاف الصيغة تلقائيًا ومعاينة الإدخالات الأولى.
  3. سمِّه وأكِّد النوع. أعطِ المصدر اسمًا وتحقق من الصيغة المكتشفة (MRSS أو RSS أو CSV أو JSON) ونوع الفيديو.
  4. اختر الوضع. تضمين لتخزين روابط المشغِّل، أو تنزيل لجلب الملفات وترميزها.
  5. عيِّن الأعمدة إن لزم. تتعيَّن MRSS و RSS تلقائيًا؛ بالنسبة لـ CSV/JSON، اسحب كل عمود إلى الحقل المناسب.
  6. حدِّد الجدول الزمني والخيارات. اختر فترة التحديث وقاعدة التكرار والنشر التلقائي وعدد الصفحات للزحف.
  7. احفظ. استخدم جلب الآن للسحب فورًا، أو دع الجدول الزمني يعمل. تشغيل قائمة الانتظار يُعالج أي عناصر معلَّقة عند الطلب.

تعيين الحقول

تُوحِّد الخلاصات الإدخالات على نفس الحقول القانونية التي يستخدمها المستورد. بالنسبة لـ MRSS/RSS هذا تلقائي؛ أما بالنسبة لـ CSV/JSON فتُعيِّن أعمدتك على:

title
مطلوب. تُتجاهَل الإدخالات التي لا تحتوي على عنوان.
video_url
ملف مباشر قابل للتنزيل — يُستخدم في وضع التنزيل.
embed_url
عنوان URL للمشغِّل — يُستخدم في وضع التضمين.
guid
معرِّف فريد يُستخدم لإزالة التكرار.
thumbnail, description, duration, published_at, views
بيانات وصفية اختيارية للفيديو.
categories, tags, performers, channels
أسماء مفصولة بفاصلة، تُنشأ إذا لم تكن موجودة.
URL واحد كافٍ. في وضع التضمين، يضطلع video_url الفردي بدور رابط التضمين إذا لم تُعيِّن embed_url، لذا تحتاج الخلاصة الأساسية فقط إلى عنوان و URL واحد.

الجدولة والأتمتة

مهمة خلفية باسم feed_import تعمل على pseudo-cron كل 30 ثانية تقريبًا — لا حاجة لـ crontab النظام. يُجلب كل مصدر فقط عندما تنقضي فترته الزمنية:

  • يدوي فقط — لا يُجلب تلقائيًا أبدًا؛ استخدم جلب الآن.
  • كل 15 دقيقة، كل ساعة، كل 6 ساعات أو كل يوم.

تُفرِّغ المهمة نفسها أيضًا قائمة انتظار الاستيراد — تُعالج عناصر التضمين عدةً في المرة الواحدة، والتنزيلات واحدًا في المرة الواحدة حتى لا يُوقف ملف كبير بقية العناصر. يحدِّد إعداد الحد الأقصى للصفحات (1–50) عمق زحف جلب واحد في خلاصة مُقسَّمة على صفحات.

يحتاج cron إلى الزيارات. لا يعمل pseudo-cron إلا عند زيارة موقعك. في موقع جديد أو غير نشط، حمِّل صفحةً لتشغيله — أو قم بإعداد مهمة cron حقيقية لضمان التوقيت (راجع cron و CLI).

إزالة التكرار والفلاتر

إزالة التكرار تلقائية وتعمل على مستويين:

  • لكل مصدر. يُحفظ guid كل عنصر، لذا يُضيف إعادة الجلب إلى قائمة الانتظار فقط الإدخالات الجديدة فعلًا (العناصر المرئية سابقًا تُعدُّ وتُتجاهَل).
  • عبر موقعك. في وضع التنزيل يُخزَّن معرِّف العنصر على الفيديو، لذا لا تُنزَّل المقطع نفسه الوارد من خلاصتين مرتين.

يُحدِّد خيار عند التكرار ما يحدث حين يوجد عنصر بالفعل: تخطِّي (مُوصى به) أو تحديث الموجود.

لا يوجد فلتر بالكلمات المفتاحية. لا تحتوي الخلاصات على فلتر تضمين/استبعاد بالكلمات المفتاحية — حدِّد نطاق الخلاصة بتوجيهها إلى URL خاص بفئة أو وسم في المصدر، واستخدم الحد الأقصى للصفحات لتقييد العمق. مسح عناصر المصدر يُعيد تعيين ذاكرة إزالة التكرار لكنه لا يحذف الفيديوهات التي استوردتها بالفعل.

استكشاف أخطاء الخلاصات

  • «لا يمكن التعرف على صيغة الخلاصة.» لم يُرجع URL صيغة MRSS/RSS/CSV/JSON صالحة. افتحه في متصفح وتأكد من رؤية الخلاصة الخام، لا صفحة HTML.
  • عناصر عالقة في «الاستيراد». تتعافى تلقائيًا بعد نحو 30 دقيقة وتُعاد المحاولة؛ يُعاد تجربة الإخفاقات العابرة حتى ثلاث مرات قبل وضع علامة الفشل.
  • العناصر الفاشلة. استخدم إعادة المعالجة لإعادة وضع كل ما فشل من مصدر في قائمة الانتظار. يعرض كل مصدر آخر حالة ورسالة له.
  • وضع التنزيل يفشل. يحتاج التنزيل إلى عنوان URL مباشر للفيديو (ليس صفحة مشاهدة)؛ المضيفون الخاصون أو الداخليون محجوبون، والحد الأقصى 5 غيغابايت لكل ملف.
  • لا شيء يُستورد. تحقق من أن الجدول الزمني ليس يدويًا فقط، وأن المصدر مُفعَّل، وأن موقعك يتلقى زيارات تُشغِّل cron.

الخطوات التالية

لا تزال عالقاً؟

افتح تذكرة من لوحة التحكم وسيساعدك فريقنا.

جرّب العرض التجريبي المباشر → تحميل TubePress →