تقويم وفعاليات Discourse

[Discourse]

	ملخص	يضيف Discourse Calendar and Events ميزات التقويم والفعاليات الديناميكية والتفاعلية إلى موقع Discourse الخاص بك.
	دليل التثبيت	يتم تضمين هذا المكوّن الإضافي مع نواة Discourse. لا حاجة لتثبيت المكوّن الإضافي بشكل منفصل.

نظرًا لأن هذا مكوّن إضافي #رسمي يُصان بواسطة فريق Discourse، يمكن تقديم طلبات #الدعم، و#المساهمة:أخطاء، و#المساهمة:تجربة_المستخدم، و#المساهمة:ميزات في الفئات المناسبة هنا على Meta، مع وضع علامة المكوّن الإضافي المناسبة. انقر على الرابط أدناه لبدء واحدة.

دعم خطأ تجربة المستخدم ميزة

تفعيل التقويم والفعاليات

يمكن تفعيل مكوّن التقويم والفعاليات إما عن طريق مفتاح التبديل أو من خلال إعداداته، وكلاهما متاح من صفحة 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.

يمكنك العثور على معلومات أكثر تفصيلية حول كيفية إنشاء واستخدام التقويمات في:

إنشاء وإدارة التقويمات

يشرح هذا الدليل كيفية إنشاء وإدارة التقويمات في Discourse باستخدام إضافة التقويم (والأحداث) (Calendar (and Event)). مستوى المستخدم المطلوب: جميع المستخدمين تُعد التقويمات ميزة قوية في Discourse تتيح لك تنظيم وعرض الأحداث داخل مجتمعك. سيرشدك هذا الدليل خلال عملية إنشاء التقويمات وإضافة الأحداث وإدارتها بفعالية. الملخص تفعيل إضافة التقويم (Calendar) إنشاء تقويم في موضوع أو فئة إضافة أحداث إلى التقويم الخاص بك إدارة خيارات وإعدادات التقويم استخدام ميزة تقويم ا…

الفعاليات

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

إنشاء وإدارة الأحداث

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

لا ينبغي الخلط بين هذا ومكوّن 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.

إنشاء فعالية بث مباشر

لإنشاء فعالية بث مباشر:

1. افتح موضوعًا جديدًا.
2. حدد أيقونة + في شريط أدوات الكاتب وانقر على إنشاء فعالية (إذا لم تكن الفعالية قد تمت إضافتها إلى موضوعك بالفعل).
3. الصق الرابط إلى فيديو الفعالية (مثل رابط YouTube) في حقل الموقع/الرابط.
4. فعّل “البث المباشر”

سترى بعد ذلك أن الفعالية والبث المباشر قد تم إنشاؤهما، مع قناة دردشة مرافقة على الجانب الأيمن.

بمجرد أن ينقر أي مستخدم على سوف أحضر في الفعالية، سينضم تلقائيًا إلى قناة الدردشة، مما يسمح له بالمشاركة في المحادثة!

بث ندوات Zoom

يمكنك استخدام البث المباشر لاستضافة ندوات Zoom مباشرة في Discourse، بحيث يمكن للأعضاء مشاهدة الفعالية والمشاركة في قناة الدردشة المرافقة دون مغادرة مجتمعك.

المتطلبات الأساسية لندوات Zoom

بالإضافة إلى متطلبات البث المباشر، ستحتاج أيضًا إلى تكوين الإعدادات التالية:

• فعّل livestream zoom enabled
• أدخل مفتاح SDK لاجتماعات Zoom في إعداد livestream zoom sdk key
• أدخل سري SDK لاجتماعات Zoom في إعداد livestream zoom sdk secret

للحصول على مفتاح وسري SDK لاجتماعات Zoom:

1. انتقل إلى marketplace.zoom.us، انقر على Develop، ثم انقر على Build app.
   

   

2. عند سؤالك عن نوع التطبيق الذي تقوم بإنشائه، اختر General App وانقر على Create.
   

   

3. من صفحة App Credentials للتطبيق، انسخ Client ID (مفتاح SDK) و Client Secret (سري SDK).

   

4. تحت Embed، فعّل إذن Meeting SDK.

   

5. في Discourse الخاص بك، انتقل إلى Admin → All site settings وأدخل القيم من الخطوة 3 في livestream zoom sdk key و livestream zoom sdk secret.

لكي تعمل ندوة Zoom بشكل صحيح في Discourse:

• لا ينبغي أن تتطلب الندوة تسجيلًا أو رمز مرور للانضمام.

• عطّل دردشة ندوات Zoom المدمجة لضمان حدوث جميع المناقشات في قناة دردشة Discourse الموحدة لإبقاء جميع الدردشات في مكان واحد وضمان استمرار المحادثة بعد انتهاء الندوة.

  

إنشاء فعالية بث مباشر لندوة Zoom

لإنشاء فعالية بث مباشر لندوة Zoom الخاصة بك:

1. افتح موضوعًا جديدًا، حدد أيقونة +، وانقر على إنشاء فعالية.
2. الصق رابط ندوة Zoom الخاص بك (مثل https://zoom.us/``...) في حقل URL/الموقع.
3. فعّل البث المباشر.
4. اضبط اسم الفعالية، وقت البدء، وقت الانتهاء، وتفاصيل الفعالية الأخرى حسب الرغبة.
5. انشر الموضوع.

مثل فعاليات البث المباشر الأخرى، سيتم إنشاء هذه الفعالية مع قناة دردشة 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

---

1. categoryId هو الفئة التي سيتم عرض التقويم فوقها.
   postId هو المنشور الذي تضع فيه التقويم باستخدام [calendar][/calendar] ↩︎

2. يمكنه عرض منتقي المنطقة الزمنية في أعلى يمين التقويم. الافتراضي هو False، يمكنك تفعيله باستخدام tzPicker=true ↩︎

3. يمكنه إخفاء أيام السبت والأحد من التقويم. الافتراضي هو True. يمكنك ضبطه على false باستخدام weekends=false. ↩︎

4. سيضبط defaultView عرض التقويم (يوم، أسبوع، إلخ). يمكن ضبطه كـ:
   
   defaultView=agendaDay
   defaultView=agendaWeek
   defaultView=month (افتراضي)
   defaultView=listNextYear ↩︎

[martyn_thomas]

هذه الإضافة واعدة - ولكن هناك بعض الميزات المفقودة التي تمنعنا من الانتقال من إضافة Pavilion

• عرض الأحداث غير طوال اليوم مع وقت البدء في التقويم، حاليًا كل حدث يبدو كحدث طوال اليوم.

• زر “إضافة حدث” في المنشئ بجوار محدد العلامات (وليس مخفيًا في الترس)

• تحديد الفئات التي يمكن أن تحتوي على أحداث، وما إذا كانت الأحداث إلزامية في فئة ما

ميزات مرغوبة:

• بيانات وصفية للحدث في الموضوع تظهر/تدخل فقط في أعلى الموضوع (بدلاً من أي مكان يكون المؤشر فيه)
• القدرة على تحديد المجموعات التي يمكنها إنشاء أحداث في فئة (على سبيل المثال - يمكن لمجموعة ‘EventPlanners’ فقط إنشاء أحداث في فئة ‘Discussion’، ولكن يمكن لجميع المستخدمين إنشاء مواضيع غير أحداث (أو تعديل المواضيع إذا تم تعيين الموضوع على Wiki)
• تغيير عنوان URL من /upcoming-events إلى /calendar

[pokapow]

مرحباً،
شكراً لك على هذا العمل.

لدي سؤالان حول تجربة المستخدم (UX):

• هل من الممكن عرض زر “إضافة حدث” بجوار زر “إضافة موقع” في محرر الموضوع؟ كما كان الحال مع إضافة pavillion؟
  

• هل هناك إمكانية لإضافة إدخال قائمة علوية للتقويم؟ لا أجده في الإعدادات
  

  

[AstonJ]

يبدو هذا رائعًا! بعض الأفكار/الأسئلة:

هل أفترض بشكل صحيح أنه لإنشاء تقويم، ما عليك سوى إنشاء سلسلة/موضوع جديد، ولصق ما يلي فيه:

اسم التقويم

[calendar]
[/calendar]

ثم لإضافة إدخالات إلى التقويم، ما عليك سوى إنشاء منشور جديد في نفس السلسلة بشيء مثل ما يلي (بالنقر على أيقونة إدراج الوقت/التاريخ في خيارات المنشور):

اسم الحدث/الإدخال

[date-range from=2024-04-18 to=2024-04-19 timezone="Europe/London"]

هذا يضيف الإدخال إلى التقويم وهو أمر رائع، ومع ذلك:

• هل هناك أي طريقة لإضافة إدخالات إلى تقويم ولكن السماح لتلك الإدخالات بأن يكون لها سلسلة/موضوع مخصص أيضًا؟ (أرى أنه يمكنك إضافة أحداث في سلاسل جديدة، ولكن لا يبدو أن هناك أي طريقة لإضافة تلك الأحداث إلى تقويم).
• هل هناك أي طريقة لعرض “الأحداث القادمة” من تقويم معين في رسائل البريد الإلكتروني الملخصة؟ أو ربما العمود الأيسر، مع ربط كل إدخال بالسلسلة المخصصة لهذا الإدخال؟

إذا لم يكن هذا ممكنًا حاليًا، فهل لديك أي خطط لإضافته؟

[haozi (耗子)]

@vinothkannans هل يمكنك مساعدتي في مراجعة طلب السحب هذا؟

FEATURE: add China holidays and region

[putty]

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

[jordan-violet]

@putty

هل هناك خطط لإضافة موجز URL يمكن للمستخدمين الاشتراك فيه؟ أنا متأكد من أنه سيكون من الصعب لجميع الأحداث مقابل تلك التي قاموا بتأكيد حضورها.

Finding Discourse RSS feeds

A reference list of all the RSS feeds available in Discourse. Required user level: All users Here’s a list of most of the available RSS feeds in Discourse. RSS is a standardised, computer-readable format for content that allows it to be shared between sites and platforms easily. RSS links that contain an ID (categories, topics, badges, etc.) are defined by their ID. The links won’t break if the slug part of the URL changes, but the slug…

لا يوجد موجز RSS لرابط /upcoming-events على الرغم من ذلك - سيكون ذلك إضافة لطيفة!

[pokapow]

ماذا عن مزامنة caldav؟

[Matthias_Schuster (Matthias)]

سيكون ذلك سببًا لي للتبديل أيضًا، في الواقع.

[Heliosurge (Dan DeMontmorency)]

هذا يحتاج إلى المزيد من التحديث لأنه يذكر إدراج حدث في الملحن وإضافة تفاصيل الحدث كما هو موضح في الصورة. هل كان الحدث إضافة؟

[Isambard]

لقد قمت بتثبيت المكون الإضافي ويعمل وسم التقويم في المنشور الأول للموضوع. لكنني لا أرى أي خيارات للحدث أو التقويم في قائمة الترس:

هل يمكن لأحد أن يشرح لي ما أحتاج إلى القيام به للحصول على خيار الحدث في قائمة الترس؟

[JammyDodger]

تحتاج إلى تمكين قسم “الحدث” للمكوّن الإضافي discourse post event enabled

[Isambard]

شكرا. لقد فاتني هذا الإعداد بطريقة ما.

[Heliosurge (Dan DeMontmorency)]

كيف يمكنك جعل حدث الإنشاء يظهر في موضوع فئة مع كون الردود أحداثًا؟

أرى أن إنشاء حدث يعمل عند إنشاء مواضيع جديدة. لكنني أتطلع إلى وجود تقويم في موضوع مع إضافة أحداث في الردود. إنه يعمل جزئيًا مع إدراج التاريخ ولكنه ليس جيدًا مثل إنشاء حدث لديه المزيد من الخيارات.

[eve (Phú)]

يمكن للمستخدمين حاليًا تحديد المنطقة في تفضيلات ملفهم الشخصي.

أود أن أسمح لهم بتحديد منطقتهم أثناء التسجيل عن طريق عرض هذا الحقل في نموذج التسجيل. هل هذا ممكن؟

[joo (slower)]

هل سيظهر الرد المحذوف في التقويم؟

[tonninseteli (se oli tonnin seteli)]

لا يمكنني العثور على أي إعداد لتغيير اليوم الأول من الأسبوع إلى الاثنين، هل هذا أمر بسيط للتنفيذ إذا كان مفقودًا؟

هناك مشكلة أخرى وهي أن إدخال الوقت والتاريخ معطل، إذا كان حدثًا لليوم كله، فيجب أن يكون هناك خيار لتحديده قبل أن تتسبب حقول إدخال الوقت في إفساد التواريخ، ويبدو أن التواريخ تتغير بشكل عشوائي عند التعديل.

لاحظت أيضًا أنه من الممكن إدخال 00:00 في كل من الوقت والتاريخ، (مما يعمل أحيانًا ولا يعمل أحيانًا أخرى) مما يؤدي إلى ظهور خطأ في التقويم والذي سيؤدي بعد ذلك إلى حدوث تعارض مع المسودات مما يؤدي إلى تكرار خطأ 422 حتى يتم التراجع عن الصفحة إلى مراجعة سابقة، ثم إعادة تحريرها وما إلى ذلك.

[joo (slower)]

@joo

عند تفعيل هذه الأتمتة، تتم إضافة محتوى “آخر تعديل بواسطة” تلقائيًا إلى التقويم. أبحث عن نصيحة حول ما إذا كانت هذه مشكلة أم أنها مشكلة في إعداداتي. هل يمكن لأي شخص المساعدة في توضيح ذلك؟

يرجى الرجوع هنا

[Jagster (Jakke Flemming)]

@tonninseteli

لا يمكنني العثور على أي إعداد لتغيير اليوم الأول من الأسبوع إلى الاثنين، هل هذا سهل التنفيذ إذا كان مفقودًا؟

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