| ملخص | يُمكّن Discourse Zoom مسؤولي ومستخدمي Discourse الذين يمتلكون اشتراك Zoom مدفوعًا من جدولة وإدارة والمشاركة في ندوات Zoom مباشرةً من منصة Discourse الخاصة بهم. | |
| رابط المستودع | https://github.com/discourse/discourse-zoom | |
| دليل التثبيت | كيفية تثبيت الإضافات في Discourse |
نظرة عامة
تدمج هذه الإضافة ندوات Zoom في مثيل Discourse. يمكن ربط ندوات Zoom بالمواضيع، ويمكن للمستخدمين التسجيل في الندوات والانضمام إليها عند بدايتها.
نظرًا لأن Zoom قد ألغت مصادقة JWT، اعتبارًا من 1 أغسطس 2023، تغيرت آلية المصادقة في الإضافة من JWT (التي أصبحت الآن ملغاة وسيتم إزالتها من Zoom في 1 سبتمبر) إلى OAuth من خادم إلى خادم. يحتاج المستخدمون الحاليون للإضافة إلى تحديث إعداداتهم.
الميزات
- عند بدء ندوة Zoom، يتحول زر “التسجيل” تلقائيًا إلى “انضمام”، وعند النقر عليه يتم تشغيل الندوة باستخدام Zoom SDK في نقطة نهاية مخصصة داخل مجتمع Discourse الخاص بك
- يقوم بتذكير المشاركين في الندوة تلقائيًا قبل N دقيقة من الحدث (N قابل للتكوين في إعدادات الإضافة، وفي الوضع الافتراضي تكون التنبيهات معطلة)
- يمكن للمسؤولين إضافة مشاركين في لوحة المناقشة إلى ندوة في Discourse
- يمكن للمسؤولين إضافة رابط لتسجيلات الفيديو للندوة في Discourse، والتي يتم عرضها للمستخدمين بعد انتهاء الحدث
- يرتبط مضيفو الندوات ومشاركو لوحة المناقشة في Zoom بحسابات المستخدمين في Discourse
الاستخدام
لاستخدام إضافة Discourse Zoom، يجب أولًا تثبيتها في مثيل Discourse الخاص بك وتكوينها باستخدام بيانات اعتماد تطبيق OAuth من خادم إلى خادم الخاص بـ Zoom. بمجرد إعداد الإضافة، يمكنك إنشاء ندوة Zoom جديدة بإنشاء موضوع جديد وربطه بالندوة. يمكن للمستخدمين بعد ذلك التسجيل في الندوة مباشرةً من الموضوع.
التثبيت
الخطوة 1: تثبيت الإضافة في مثيل Discourse الخاص بك
يمكنك تثبيت الإضافة في مثيل Discourse الخاص بك باتباع التعليمات هنا.
الخطوة 2: إنشاء تطبيق OAuth من خادم إلى خادم في Zoom Marketplace
للبداية، ستحتاج إلى إنشاء تطبيق OAuth من خادم إلى خادم في Zoom Marketplace. سيكون هذا التطبيق مطلوبًا لإجراء طلبات إلى واجهة برمجة تطبيقات Zoom واستقبال إشعارات الأحداث عبر Webhooks
الخطوة 3: تكوين الإضافة
بمجرد تثبيت الإضافة، انتقل إلى إعدادات موقع Discourse الخاص بك وحدد خانة الاختيار zoom enabled ثم احفظ التغييرات.
من Zoom Marketplace، انتقل إلى علامة التبويب App Credentials:
ثم انسخ والصق القيم في إعدادات الموقع المقابلة في مثيل Discourse الخاص بك:
zoom s2s account idzoom s2s client idzoom s2s client secret
الخطوة 4: تعيين رمز سرية Webhook
في علامة التبويب Feature لتطبيق OAuth من خادم إلى خادم الخاص بـ Zoom، انسخ “Secret Token” وأضفه إلى إعداد موقع Discourse الخاص بك zoom webhooks secret token.
الخطوة 5: تفعيل اشتراكات الأحداث
بينما لا تزال في علامة التبويب Feature لتطبيق OAuth من خادم إلى خادم الخاص بـ Zoom، قم بتفعيل “Event Subscriptions” ثم انقر على زر Add Event Subscription:
بعد ذلك، قم بتعيين “Event notification endpoint URL” إلى:
https://YOURSITE.COM/zoom/webhooks/webinars.json
ثم انقر على زر + Add Events:
افتح علامة التبويب Webinar من قائمة أنواع الأحداث وحدد جميع الأحداث المدرجة. إذا لم تتمكن من رؤية أذونات حدث Webinar، فراجع كيفية تمكين الأذونات.
تحت عنوان “Event notification endpoint URL” الذي قمت بتعيينه سابقًا، ابحث عن زر Validate:
يجب أن يظهر
إذا كان كل شيء يعمل بشكل صحيح.
أخيرًا، انقر على زر Save في أسفل الصفحة
الخطوة 6: النطاقات (Scopes)
بمجرد تعيين اشتراكات الأحداث، انتقل إلى علامة التبويب Scopes، ثم انقر على زر Add Scopes. هنا ستقوم باختيار النطاقات التالية إما بالبحث عن القيم المذكورة في الجداول، يدويًا، أو باستخدام قيم جزئية، على سبيل المثال بدلاً من البحث عن webinar:read:list_panelists:admin ابحث عن webinar:read:، مما سيضيء العناصر المعروضة لتسهيل العثور على المطلوبة.
في تطبيق OAuth من خادم إلى خادم تحت علامة التبويب scopes، انقر على زر Add Scopes وستظهر نافذة:
في مربع البحث عن النطاق، ابحث بالاسم الكامل أو الجزئي. لتسهيل ذلك، يمكنك نسخ ولصق كل نطاق من النطاقات في الجداول التالية أو البحث عنها تحت علامة التبويب المقابلة:
المستخدمين
| scope | desc |
|---|---|
| user:read:user:admin | عرض مستخدم |
| user:read:email:admin | التحقق من بريد المستخدم الإلكتروني |
| user:read:list_users:admin | عرض المستخدمين |
الندوات
| scope | desc |
|---|---|
| webinar:read:list_panelists:admin | عرض مشاركي لوحة المناقشة في ندوة |
| webinar:read:list_absentees:admin | عرض الغائبين عن ندوة سابقة |
| webinar:read:webinar:admin | عرض ندوة |
| webinar:read:registrant:admin | عرض مشارك في ندوة |
| webinar:read:list_registrants:admin | عرض المشاركين في ندوة |
| webinar:write:batch_registrants:admin | إضافة مشاركين إلى ندوة |
| webinar:delete:webinar:admin | حذف ندوة |
| webinar:write:panelist | إضافة مشاركين في لوحة المناقشة إلى ندوة |
| webinar:delete:registrant | إزالة مشارك من ندوة |
| webinar:write:webinar | إنشاء ندوة لمستخدم |
| webinar:update:status | تحديث حالة ندوة |
| webinar:delete:panelist | إزالة مشارك في لوحة المناقشة من ندوة |
| webinar:update:webinar | تحديث ندوة |
| webinar:write:registrant | إضافة مشارك إلى ندوة |
الندوات
| scope | desc |
|---|---|
| webinar:read:list_panelists:admin | عرض مشاركي لوحة المناقشة في ندوة |
| webinar:read:list_absentees:admin | عرض الغائبين عن ندوة سابقة |
| webinar:read:webinar:admin | عرض ندوة |
| webinar:read:registrant:admin | عرض مشارك في ندوة |
| webinar:read:list_registrants:admin | عرض المشاركين في ندوة |
| webinar:write:batch_registrants:admin | إضافة مشاركين إلى ندوة |
| webinar:delete:webinar:admin | حذف ندوة |
| webinar:write:panelist | إضافة مشاركين في لوحة المناقشة إلى ندوة |
| webinar:delete:registrant | إزالة مشارك من ندوة |
| webinar:write:webinar | إنشاء ندوة لمستخدم |
| webinar:update:status | تحديث حالة ندوة |
| webinar:delete:panelist | إزالة مشارك في لوحة المناقشة من ندوة |
| webinar:update:webinar | تحديث ندوة |
| webinar:write:registrant | إضافة مشارك إلى ندوة |
الخطوة 7: إنشاء تطبيق Meeting SDK
قامت Zoom بتغيير بعض الأمور من جانبها، نحن نعمل على تحديث الدليل.
تقوم تطبيق اجتماعات SDK بمصادقة المستخدم بحيث يمكن للمستخدم الانضمام إلى اجتماع الندوة
ابدأ بإنشاء General App، ثم تحت Select how the app is managed، اختر User-managed.
تحت علامة التبويب Basic Information في تطبيق General App الخاص بك، انسخ والصق Client ID/ SDK key في حقل zoom sdk key، و Client Secret/SDK secret في حقل zoom sdk secret.
بالتمرير لأسفل، ستجد قسم OAuth Information، في حقل OAuth Redirect URL ضع عنوان URL لموقعك، على سبيل المثال، https://YOURSITE.com.
الخطوة 8: تحديد استخدام التطبيق الخاص بك
تحت علامة التبويب Features اختر علامة التبويب الفرعية Embed، ثم قم بتفعيل Meeting SDK
القيود
تعمل الإضافة فقط مع الندوات التي لا تتطلب تسجيلًا في Zoom.
إشعار بشأن التغييرات الكاسرة
بسبب إلغاء بعض الميزات في واجهة برمجة تطبيقات Zoom، ستحتاج النسخ القديمة من الإضافة إلى التكوين باتباع الخطوات المذكورة في هذا المنشور.
مستضافون لدينا؟ هذه الإضافة متاحة في خططنا المؤسسية.
















