زر زوم للديسكورس

تخصيص إضافة
,
1
:discourse2: ملخص يُمكّن Discourse Zoom مسؤولي ومستخدمي Discourse الذين يمتلكون اشتراك Zoom مدفوعًا من جدولة وإدارة والمشاركة في ندوات Zoom مباشرةً من منصة Discourse الخاصة بهم.
:hammer_and_wrench: رابط المستودع https://github.com/discourse/discourse-zoom
:open_book: دليل التثبيت كيفية تثبيت الإضافات في Discourse

نظرة عامة

تدمج هذه الإضافة ندوات Zoom في مثيل Discourse. يمكن ربط ندوات Zoom بالمواضيع، ويمكن للمستخدمين التسجيل في الندوات والانضمام إليها عند بدايتها.

:warning: نظرًا لأن 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:

App Credentials
App Credentials2130×1474 221 KB

ثم انسخ والصق القيم في إعدادات الموقع المقابلة في مثيل Discourse الخاص بك:

  • zoom s2s account id
  • zoom s2s client id
  • zoom s2s client secret

الخطوة 4: تعيين رمز سرية Webhook

في علامة التبويب Feature لتطبيق OAuth من خادم إلى خادم الخاص بـ Zoom، انسخ “Secret Token” وأضفه إلى إعداد موقع Discourse الخاص بك zoom webhooks secret token.

Webhooks Secret Token
Webhooks Secret Token2376×1230 209 KB

الخطوة 5: تفعيل اشتراكات الأحداث

بينما لا تزال في علامة التبويب Feature لتطبيق OAuth من خادم إلى خادم الخاص بـ Zoom، قم بتفعيل “Event Subscriptions” ثم انقر على زر Add Event Subscription:

Event Subscriptions toggle and "Add Event Subscription" button
Event Subscriptions toggle and "Add Event Subscription" button1634×734 57.8 KB

بعد ذلك، قم بتعيين “Event notification endpoint URL” إلى:

https://YOURSITE.COM/zoom/webhooks/webinars.json

ثم انقر على زر + Add Events:

Event notification endpoint URL and "Add Events" button
Event notification endpoint URL and "Add Events" button1052×1378 110 KB

افتح علامة التبويب Webinar من قائمة أنواع الأحداث وحدد جميع الأحداث المدرجة. إذا لم تتمكن من رؤية أذونات حدث Webinar، فراجع كيفية تمكين الأذونات.

Untitled
Untitled908×586 43.7 KB

تحت عنوان “Event notification endpoint URL” الذي قمت بتعيينه سابقًا، ابحث عن زر Validate:

Validate button under "Event notification endpoint URL"
Validate button under "Event notification endpoint URL"1204×370 59.3 KB

يجب أن يظهر أيقونة علامة صح مع كلمة "Validated" باللون الأخضر إذا كان كل شيء يعمل بشكل صحيح.

أخيرًا، انقر على زر Save في أسفل الصفحة

الخطوة 6: النطاقات (Scopes)

بمجرد تعيين اشتراكات الأحداث، انتقل إلى علامة التبويب Scopes، ثم انقر على زر Add Scopes. هنا ستقوم باختيار النطاقات التالية إما بالبحث عن القيم المذكورة في الجداول، يدويًا، أو باستخدام قيم جزئية، على سبيل المثال بدلاً من البحث عن webinar:read:list_panelists:admin ابحث عن webinar:read:، مما سيضيء العناصر المعروضة لتسهيل العثور على المطلوبة.

This is a screenshot of the "Add Scope" feature from the Zoom web client, showing a dialog box with fields for product name, team name, and account name. (Captioned by AI)
This is a screenshot of the "Add Scope" feature from the Zoom web client, showing a dialog box with fields for product name, team name, and account name. (Captioned by AI)2263×760 92.8 KB

في تطبيق OAuth من خادم إلى خادم تحت علامة التبويب scopes، انقر على زر Add Scopes وستظهر نافذة:

This image shows a computer screen with a form to add scopes to an account. (Captioned by AI)
This image shows a computer screen with a form to add scopes to an account. (Captioned by AI)2267×1576 308 KB

في مربع البحث عن النطاق، ابحث بالاسم الكامل أو الجزئي. لتسهيل ذلك، يمكنك نسخ ولصق كل نطاق من النطاقات في الجداول التالية أو البحث عنها تحت علامة التبويب المقابلة:

The image is a screenshot of a user interface, showing a form for entering user information. (Captioned by AI)
The image is a screenshot of a user interface, showing a form for entering user information. (Captioned by AI)1877×586 43.7 KB

المستخدمين

scope desc
user:read:user:admin عرض مستخدم
user:read:email:admin التحقق من بريد المستخدم الإلكتروني
user:read:list_users:admin عرض المستخدمين

This image displays a list of user-created webinars, with a variety of topics and panel configurations. (Captioned by AI)
This image displays a list of user-created webinars, with a variety of topics and panel configurations. (Captioned by AI)1900×1597 272 KB

This is a screenshot of a user interface showing a list of actions that can be done on webinars. (Captioned by AI)
This is a screenshot of a user interface showing a list of actions that can be done on webinars. (Captioned by AI)1924×1412 254 KB

الندوات

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

:warning: قامت 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.

This image displays a screenshot of an app's basic information page. (Captioned by AI)
This image displays a screenshot of an app's basic information page. (Captioned by AI)1699×1427 197 KB

بالتمرير لأسفل، ستجد قسم OAuth Information، في حقل OAuth Redirect URL ضع عنوان URL لموقعك، على سبيل المثال، https://YOURSITE.com.

This image shows a section of a webpage with a form to add a new OAuth 2.0 redirect URL. (Captioned by AI)
This image shows a section of a webpage with a form to add a new OAuth 2.0 redirect URL. (Captioned by AI)1755×1091 87.1 KB

الخطوة 8: تحديد استخدام التطبيق الخاص بك

تحت علامة التبويب Features اختر علامة التبويب الفرعية Embed، ثم قم بتفعيل Meeting SDK

A screenshot of an Android device screen with text instructions on how to use Google Meet. (Captioned by AI)
A screenshot of an Android device screen with text instructions on how to use Google Meet. (Captioned by AI)2842×1434 358 KB

القيود

تعمل الإضافة فقط مع الندوات التي لا تتطلب تسجيلًا في Zoom.

إشعار بشأن التغييرات الكاسرة

بسبب إلغاء بعض الميزات في واجهة برمجة تطبيقات Zoom، ستحتاج النسخ القديمة من الإضافة إلى التكوين باتباع الخطوات المذكورة في هذا المنشور.

:discourse2: مستضافون لدينا؟ هذه الإضافة متاحة في خططنا المؤسسية.

63 إعجابًا
Hosting Webinars on Discourse?
BigBlueButton video conference
Can we host events in discourse?
Tips for hosting large events?
Host Zoom Events in Discourse
Discourse Zoom validate endpoint URL issue (discourse log shows errors)
Clarification on Zoom permissions
Discourse as a Conference App (in person, virtual, or hybrid)