| ملخص | يضيف Discourse Calendar and Events ميزات التقويم والفعاليات الديناميكية والتفاعلية إلى موقع Discourse الخاص بك. | |
| دليل التثبيت | يتم تضمين هذا المكوّن الإضافي مع نواة Discourse. لا حاجة لتثبيت المكوّن الإضافي بشكل منفصل. |
تفعيل التقويم والفعاليات
يمكن تفعيل مكوّن التقويم والفعاليات إما عن طريق مفتاح التبديل أو من خلال إعداداته، وكلاهما متاح من صفحة admin/plugins الخاصة بك:
الميزات
كما قد تتوقع، يضيف Discourse Calendar and Events كلًا من ميزات التقويم والفعاليات إلى موقع Discourse الخاص بك. من خلال هذه الميزات، يمكنك إنشاء تقويمات مواضيع فردية لتتبع المناسبات المهمة أو الخطوط الزمنية، وعرض التقويمات في الفئات، وإضافة تقويم للإجازات لوضع علامة على العطلات أو الغيابات أو أيام المرض، وإنشاء مواضيع فعاليات تفاعلية، بالإضافة إلى عرض ملخص تقويم سهل الوصول لجميع فعالياتك القادمة.
التقويمات
can be created in multiple topics, and ones you wish to give higher visibility to can be displayed above a category’s topic list.
يمكنك العثور على معلومات أكثر تفصيلية حول كيفية إنشاء واستخدام التقويمات في:
الفعاليات
تتيح ميزة الفعاليات إدراج عناصر تفاعلية في المواضيع يمكن لأعضائك استخدامها للتسجيل للحضور أو المشاركة في أنشطة مجتمعك. يتم تلخيص كل هذه العناصر في تقويم مخصص للموقع بأكمله، مع خيار إضافة رابط سهل الوصول إلى قائمة التنقل الخاصة بك. يمكنك العثور على مزيد من المعلومات حول كيفية إنشاء واستخدام هذه الميزة في:
لا ينبغي الخلط بين هذا ومكوّن Events plugin الخاص بـ Pavilion (لاحظ صيغة الجمع)
إعدادات التقويم
| الاسم | الوصف |
|---|---|
| calendar enabled | تفعيل مكوّن discourse-calendar. سيضيف هذا دعمًا لوسم [calendar][/calendar] في المنشور الأول من الموضوع. |
| holiday calendar topic id | معرف موضوع تقويم إجازات/غياب الموظفين. |
| holiday status emoji | يحدد الرموز التعبيرية المستخدمة لحالة الإجازة. |
| delete expired event posts after | سيتم حذف المنشورات ذات الفعاليات المنتهية تلقائيًا بعد (ن) ساعة. اضبط على -1 لتعطيل الحذف. |
| all day event start time | ستبدأ الفعاليات التي لا تحتوي على وقت بداية محدد في هذا الوقت. التنسيق هو HH:mm. للساعة 6:00 صباحًا، أدخل 06:00 |
| all day event end time | ستنتهي الفعاليات التي لا تحتوي على وقت نهاية محدد في هذا الوقت. التنسيق هو HH:mm. للساعة 6:00 مساءً، أدخل 18:00 |
| calendar categories | عرض تقويم في أعلى الفئة. الإعدادات الإلزامية هي categoryId و postId. مثال: categoryId=6;postId=453[1] الإعدادات الأخرى الصالحة: tzPicker[2]، weekends[3] و defaultView[4]. |
| calendar categories outlet | يسمح بتغيير منفذ عرض تقويم الفئة. |
| working days | ضبط أيام العمل. يمكنك عرض توفر مجموعة باستخدام وسم timezones في منشور، مثال: [timezones group=admins][timezones] |
| working day start hour | وقت بداية ساعات يوم العمل. |
| working day end hour | وقت نهاية ساعات يوم العمل. |
| close to working day hours extension | ضبط وقت الامتداد في ساعات يوم العمل لإبراز المناطق الزمنية. |
| calendar automatic holidays enabled | ضبط حالة الإجازة تلقائيًا بناءً على منطقة المستخدم (ملاحظة: يمكنك تعطيل إجازات تلقائية محددة في إعدادات المكوّن الإضافي) |
| map events title | يحدد عنوان تقويم الشريط الجانبي بناءً على الفئة. الافتراضي هو “الفعاليات القادمة” |
إعدادات الفعاليات
| الاسم | الوصف |
|---|---|
| discourse post event enabled | تفعيل ميزات الفعاليات. ملاحظة: يحتاج أيضًا إلى تفعيل calendar enabled. |
| discourse post event allowed on groups | المجموعات المسموح لها بإنشاء الفعاليات. |
| displayed invitees limit | يحدد عدد المدعوين المعروضين في فعالية. |
| display post event date on topic title | يعرض تاريخ الفعالية بعد عنوان الموضوع. |
| use local event date | استخدام التاريخ المحلي بعد عنوان الموضوع بدلاً من الوقت النسبي. |
| discourse post event edit notifications time extension | يمدد (بالدقائق) الفترة بعد نهاية الفعالية عندما لا يزال يتم إعلام المدعوين الذين “سوف يحضرون” من التعديل في المنشور الأصلي. |
| discourse post event allowed custom fields | يسمح لكل فعالية بتعيين قيمة الحقول المخصصة. |
| events calendar categories | عرض تقويم الفعاليات في أعلى الفئة. |
| sort categories by event start date enabled | تفعيل فرز مواضيع الفئة حسب تاريخ بدء الفعالية. |
| disable resorting on categories enabled | السماح للفئات بتعطيل القدرة على الفرز في فئة الفعاليات. |
| sidebar show upcoming events | عرض رابط الفعاليات القادمة في الشريط الجانبي تحت “المزيد”. يتطلب post event enabled |
| map events to color | تعيين لون الفعالية لوسم أو فئة محددة |
![]()
الآن يحتوي نقطة النهاية
discourse-post-event/events.jsonعلى معلمة إضافية للتبديل بين الاستجابة البسيطة والمفصلة. للحصول على الاستجابة المفصلة يمكنك إضافة?include_details=true:
/discourse-post-event/events.json?include_details=true
فعاليات البث المباشر
بالنسبة للفعاليات المباشرة، استخدم وظيفة البث المباشر للسماح للأعضاء بمشاهدة الفعالية والمشاركة في الدردشة في نفس الوقت.
تتضمن فعالية البث المباشر:
- بث فيديو (باستخدام YouTube، على سبيل المثال)
- فعالية تقويم باستخدام Discourse Calendar and Events
- قناة دردشة مرافقة يتم إنشاؤها تلقائيًا للفعالية
المتطلبات الأساسية لفعاليات البث المباشر
لاستخدام فعاليات البث المباشر، يجب أن يكون لديك chat enabled، نظرًا لأن البث المباشر ينشئ قناة دردشة مرافقة لفعالياتك، بالإضافة إلى discourse post event enabled و calendar enabled.
إنشاء فعالية بث مباشر
لإنشاء فعالية بث مباشر:
- افتح موضوعًا جديدًا.
- حدد أيقونة + في شريط أدوات الكاتب وانقر على إنشاء فعالية (إذا لم تكن الفعالية قد تمت إضافتها إلى موضوعك بالفعل).
- الصق الرابط إلى فيديو الفعالية (مثل رابط YouTube) في حقل الموقع/الرابط.
- فعّل “البث المباشر”
سترى بعد ذلك أن الفعالية والبث المباشر قد تم إنشاؤهما، مع قناة دردشة مرافقة على الجانب الأيمن.
بمجرد أن ينقر أي مستخدم على سوف أحضر في الفعالية، سينضم تلقائيًا إلى قناة الدردشة، مما يسمح له بالمشاركة في المحادثة!
بث ندوات Zoom
يمكنك استخدام البث المباشر لاستضافة ندوات Zoom مباشرة في Discourse، بحيث يمكن للأعضاء مشاهدة الفعالية والمشاركة في قناة الدردشة المرافقة دون مغادرة مجتمعك.
المتطلبات الأساسية لندوات Zoom
بالإضافة إلى متطلبات البث المباشر، ستحتاج أيضًا إلى تكوين الإعدادات التالية:
- فعّل
livestream zoom enabled - أدخل مفتاح SDK لاجتماعات Zoom في إعداد
livestream zoom sdk key - أدخل سري SDK لاجتماعات Zoom في إعداد
livestream zoom sdk secret
للحصول على مفتاح وسري SDK لاجتماعات Zoom:
-
انتقل إلى marketplace.zoom.us، انقر على Develop، ثم انقر على Build app.
-
عند سؤالك عن نوع التطبيق الذي تقوم بإنشائه، اختر General App وانقر على Create.
-
من صفحة App Credentials للتطبيق، انسخ Client ID (مفتاح SDK) و Client Secret (سري SDK).
-
تحت Embed، فعّل إذن Meeting SDK.
-
في Discourse الخاص بك، انتقل إلى Admin → All site settings وأدخل القيم من الخطوة 3 في
livestream zoom sdk keyوlivestream zoom sdk secret.
لكي تعمل ندوة Zoom بشكل صحيح في Discourse:
-
لا ينبغي أن تتطلب الندوة تسجيلًا أو رمز مرور للانضمام.
-
عطّل دردشة ندوات Zoom المدمجة لضمان حدوث جميع المناقشات في قناة دردشة Discourse الموحدة لإبقاء جميع الدردشات في مكان واحد وضمان استمرار المحادثة بعد انتهاء الندوة.
إنشاء فعالية بث مباشر لندوة Zoom
لإنشاء فعالية بث مباشر لندوة Zoom الخاصة بك:
- افتح موضوعًا جديدًا، حدد أيقونة +، وانقر على إنشاء فعالية.
- الصق رابط ندوة Zoom الخاص بك (مثل
https://zoom.us/``...) في حقل URL/الموقع. - فعّل البث المباشر.
- اضبط اسم الفعالية، وقت البدء، وقت الانتهاء، وتفاصيل الفعالية الأخرى حسب الرغبة.
- انشر الموضوع.
مثل فعاليات البث المباشر الأخرى، سيتم إنشاء هذه الفعالية مع قناة دردشة Discourse مرافقة ينضم إليها الأعضاء تلقائيًا بعد تأكيد حضورهم بـ “سوف أحضر”.
تجربة الأعضاء
إليك كيف ستشعر أعضائك بالندوة:
قبل الفعالية
يتم عرض زر انضمام إلى Zoom قبل 30 دقيقة من بدء الفعالية. خارج هذه النافذة، يكون الزر معطلًا مع رسالة تشير إلى متى سيكون متاحًا.
أثناء الفعالية
بمجرد أن ينقر الأعضاء على انضمام إلى Zoom، ستتم تحميل الندوة في صفحة الموضوع (أو، إذا لم يبدأ المضيف الفعالية بعد، سيحتاج العضو إلى الانتظار حتى يفعل ذلك لرؤية الفيديو).
الصوت لا يتصل تلقائيًا عند الانضمام إلى الندوة؛ يحتاج الحاضرون إلى النقر أو اللمس على أيقونة الصوت في شريط أدوات Zoom للاتصال. هذا قيد في SDK الخاص بـ Zoom ولا يمكن تغييره.
على الهاتف المحمول، تفتح الندوة في عرض Zoom بشاشة كاملة (وهو أيضًا متاح على سطح المكتب عن طريق إضافة /zoom إلى نهاية رابط موضوع الفعالية) مع زر دردشة عائم يمكنهم النقر عليه لفتح لوحة تراكب الدردشة أثناء الفعالية.
بعد الفعالية
يتم إخفاء زر انضمام إلى Zoom بعد 10 دقائق من وقت انتهاء الفعالية. تظل قناة الدردشة متاحة للحاضرين حتى تقوم بإغلاقها.
التكامل مع المكونات الإضافية الأخرى
يمكنك استخدام مكونًا من هذا المكوّن الإضافي مع Right Sidebar Blocks. ستحتاج إلى التأكد من تمكين المسار المطلوب في مكون Right Sidebar Blocks. سيكون اسم الكتلة upcoming-events-list. تاريخيًا، كانت هناك إعدادات إضافية مطلوبة في مكوّن التقويم نفسه، لكن هذا تم تبسيطه.
هكذا سيظهر تقويم الشريط الجانبي بشكل افتراضي.
إذا لم ترغب في عرض الوقت، يمكنك إضافة قيمة timeFormat فارغة في إعداد كتلة المكون.
هل يتم استضافته لدينا؟ هذا المكوّن الإضافي متاح في طبقاتنا Business و Enterprise Calendar | Discourse - Civilized Discussion
categoryId هو الفئة التي سيتم عرض التقويم فوقها.
postId هو المنشور الذي تضع فيه التقويم باستخدام [calendar][/calendar] ↩︎يمكنه عرض منتقي المنطقة الزمنية في أعلى يمين التقويم. الافتراضي هو False، يمكنك تفعيله باستخدام tzPicker=true ↩︎
يمكنه إخفاء أيام السبت والأحد من التقويم. الافتراضي هو True. يمكنك ضبطه على false باستخدام weekends=false. ↩︎
سيضبط defaultView عرض التقويم (يوم، أسبوع، إلخ). يمكن ضبطه كـ:
defaultView=agendaDay
defaultView=agendaWeek
defaultView=month (افتراضي)
defaultView=listNextYear ↩︎


















