ملخص
تكامل تحميل الوسائط ImgLink لـ Discourse مع مفاتيح واجهة برمجة التطبيقات (API) المحددة النطاق، والتعامل مع إعادة المحاولة، وأدوات تشخيص المسؤول.
رابط المستودع
https://github.com/imglink12x/discourse-plugin
دليل التثبيت
-
تسجيل الدخول عبر SSH إلى حاوية Discourse الخاصة بك:
-
أضف المكون الإضافي إلى ملف app.yml الخاص بك:
-
أعد بناء الحاوية:
-
قم بتهيئة مفتاح API الخاص بك لـ ImgLink في إعدادات المسؤول (انظر التكوين أدناه)
للحصول على إعداد مفصل: https://imglink.cc/tools/forum-plugins
الميزات
-
التحميل المباشر من الملحن (Composer) — تحميل الصور مباشرة من محرر مشاركات Discourse
-
مفاتيح API ذات النطاق المحدود — تستخدم بيانات اعتماد ذات نطاق محدود؛ لا يوجد وصول كامل إلى الحساب
-
روابط مباشرة وعارض — إرجاع كل من روابط شبكة توصيل المحتوى (CDN) المباشرة وعناوين URL الخاصة بعارض الصور
-
إعادة المحاولة + الحتمية (Idempotency) — منطق إعادة المحاولة التلقائي للاتصالات غير المستقرة؛ يمنع التحميلات المكررة
-
تشخيص المسؤول — فحوصات صحية مدمجة للتحقق من مصادقة API والاتصال وأذونات التحميل
-
إخراج BBCode — تنسيق BBCode تلقائي للنشر المضمن
-
تسجيل الأخطاء — سجلات مفصلة لاستكشاف أخطاء التحميل الفاشلة وإصلاحها
التكوين
الخطوة 1: إنشاء مفتاح API لـ ImgLink
-
سجّل الدخول إلى ImgLink (https://imglink.cc)
-
انتقل إلى الإعدادات ← مفاتيح API
-
أنشئ مفتاحًا جديدًا بالنطاقات التالية:
-
upload:create -
image:delete(اختياري، لمهام سير عمل التنظيف)
-
-
انسخ مفتاح API
الخطوة 2: الإضافة إلى إعدادات مسؤول Discourse
-
انتقل إلى مسؤول ← الإعدادات ← المكونات الإضافية
-
قم بالتمرير إلى إعدادات ImgLink
-
الصق مفتاح API الخاص بك في حقل
imglink_api_key -
(اختياري) قم بتعيين
imglink_api_endpointإذا كنت تستخدم مثيلاً مخصصًا لـ ImgLink -
حفظ
الخطوة 3: تشغيل التشخيصات
-
انتقل إلى مسؤول ← المكونات الإضافية ← إعدادات ImgLink
-
انقر على “اختبار الاتصال” للتحقق من صحة التكوين الخاص بك
-
يجب أن ترى “✓ نجاح الاتصال”
الإعدادات
| اسم الإعداد | النوع | الافتراضي | الوصف |
|---|---|---|---|
imglink_api_key |
سلسلة نصية (String) | (فارغ) | مفتاح API الخاص بك لـ ImgLink مع نطاق upload:create |
imglink_api_endpoint |
سلسلة نصية (String) | https://imglink.cc/api/v1 |
عنوان URL الأساسي لواجهة API لـ ImgLink (اتركه افتراضيًا ما لم يكن مستضافًا ذاتيًا) |
imglink_max_retries |
عدد صحيح (Integer) | 3 |
عدد محاولات إعادة المحاولة للتحميلات الفاشلة |
imglink_retry_delay |
عدد صحيح (Integer) | 1000 |
الميلي ثانية للانتظار بين محاولات إعادة المحاولة |
imglink_timeout_ms |
عدد صحيح (Integer) | 30000 |
مهلة طلب التحميل (30 ثانية) |
imglink_enable_diagnostics |
منطقي (Boolean) | true |
تمكين أدوات تشخيص المسؤول والسجلات |
imglink_enable_direct_links |
منطقي (Boolean) | true |
إرجاع روابط CDN المباشرة بدلاً من الروابط الملتفة في العارض |
توافق الإصدار: Discourse 2.8+ | آخر تحديث: مارس 2026 | الدعم: https://imglink.cc/tools/forum-plugins