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

[Discourse]

يشرح هذا الدليل كيفية إنشاء وإدارة التقاويم في ديسكورس (Discourse) باستخدام إضافة التقويم (والأحداث) (Calendar (and Event)).

مستوى المستخدم المطلوب: جميع المستخدمين

تُعد التقاويم ميزة قوية في ديسكورس (Discourse) تتيح لك تنظيم وعرض الأحداث داخل مجتمعك. سيرشدك هذا الدليل خلال عملية إنشاء التقاويم، وإضافة الأحداث، وإدارتها بفعالية.

الملخص

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

تمكين إضافة التقويم

قبل أن تتمكن من إنشاء التقاويم، تأكد من تمكين إضافة “التقويم (والأحداث)” (Calendar (and Event)) على مثيل ديسكورس (Discourse) الخاص بك. لمزيد من التفاصيل حول تمكين الإضافة وإعداداتها ذات الصلة، راجع وثائق إضافة التقويم والأحداث لـ ديسكورس (Discourse Calendar and Event plugin documentation.

إنشاء تقويم

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

لتضمين تقويم في موضوع:

1. أنشئ موضوعًا جديدًا أو حرر المنشور الأول لموضوع موجود

2. أضف الكود التالي في أسطر منفصلة:

   [calendar]
   [/calendar]
   

3. انشر المنشور أو حدثه

يُعتبر يوم الاثنين هو اليوم الأول من الأسبوع في تقاويم ديسكورس (Discourse)، بغض النظر عن إعدادات الموقع الجغرافي للمشاهد. هذا غير قابل للتكوين حاليًا.

تقويم الفئة

لإنشاء تقويم على مستوى الفئة:

1. انتقل إلى /admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendar

2. في إعداد “فئات التقويم” (calendar categories)، أضف إدخالًا بالتنسيق التالي:

   categoryId=123;tzPicker;defaultView=month
   

   • استبدل 123 بمعرف الفئة الخاص بك (يوجد في عنوان URL عند عرض الفئة)

3. أضف معرف الفئة إلى إعداد “فئات تقويم الأحداث” (events calendar categories)

4. اختياريًا، اضبط “السماح بإضافة أحداث منشورات ديسكورس للمجموعات” (discourse post event allowed on groups) للتحكم في المجموعات التي يمكنها إضافة أحداث

إضافة عناصر إلى تقويم

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

لإضافة حدث إلى تقويم موضوع:

1. رد على الموضوع الذي يحتوي على التقويم
2. استخدم وظيفة “إدراج تاريخ / وقت” (Insert date / time) في قائمة القائمة المنسدلة للمُنشئ + لإضافة تاريخ أو نطاق تاريخ
3. أضف وصفًا فوق التاريخ
4. أرسل الرد

سيظهر الحدث في التقويم بعد إعادة تحميل الموضوع.

تقويم الفئة

لإضافة حدث إلى تقويم فئة:

1. أنشئ موضوعًا جديدًا في الفئة
2. انقر على زر الترس (gear button) وحدد “إنشاء حدث” (Create event)
3. املأ تفاصيل الحدث وانشر

سيظهر الحدث في تقويم الفئة.

خيارات التقويم

يمكنك تخصيص التقويم الخاص بك باستخدام خيارات مختلفة:

الخيار	مثال	الوصف
إخفاء عطلات نهاية الأسبوع	weekends="false"	إخفاء السبت والأحد
إخفاء أيام محددة	hiddenDays="1,2"	إخفاء الاثنين والثلاثاء (استخدم 0-6 للأحد-السبت)
تعيين العرض الافتراضي	defaultView="basicWeek"	الخيارات: month، basicWeek، listNextYear
تجاهل المناطق الزمنية	fullDay="true"	التعامل مع جميع الأحداث كأحداث ليوم كامل

مثال على الاستخدام:

[calendar weekends="false" hiddenDays="1,2" defaultView="basicWeek" fullDay="true"]
[/calendar]

إزالة عناصر التقويم

يمكن إزالة عناصر التقويم بهذه الطرق:

• يمكن إزالة عناصر التقويم المنتهية تلقائيًا باستخدام إعداد “حذف منشورات الأحداث المنتهية بعد” (delete expired event posts after)
• استخدم مؤقتات الموضوع لحذف الردود تلقائيًا
• احذف المنشورات يدويًا حسب الحاجة

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

تقويم العطلات هو ميزة خاصة لإدارة عطلات موظفي الموقع:

1. أنشئ موضوعًا يحتوي على تقويم في المنشور الأول
2. عيّن “معرف موضوع تقويم العطلات” (holiday calendar topic id) ليكون معرف هذا الموضوع
3. ستُعامل الردود على هذا الموضوع كوقت إجازة للمستخدم الذي نشرها
4. يتم تلوين إدخالات الإجازة تلقائيًا وبشكل عشوائي
5. يظهر رمز تعبيري (الافتراضي: ) بجوار أسماء المستخدمين في إجازة في بطاقات المستخدمين والإشارات (@mentions)
6. اختياريًا، قم بتضمين العطلات الخاصة بمنطقة المستخدم الجغرافية عن طريق تمكين “تمكين العطلات التلقائية للتقويم” (calendar automatic holidays enabled)

الأسئلة الشائعة

س: لماذا تبدو بعض الأحداث ممتدة على أيام متعددة؟
ج: التقويم دائمًا بتوقيت UTC. استخدم إعدادات “وقت بدء حدث اليوم الكامل” (all day event start time) و “وقت انتهاء حدث اليوم الكامل” (all day event end time) للتكيف مع اختلافات المنطقة الزمنية.

س: هل يمكنني التحكم في ألوان إدخالات تقويم العطلات؟
ج: حاليًا، ليس من الممكن التحكم في ألوان إدخالات تقويم العطلات أو الحصول على إدخالات ملونة في التقاويم العادية.

س: كيف أعرض الأحداث السابقة في عرض القائمة؟
ج: هناك خطأ حاليًا عند استخدام defaultView=listNextYear يتسبب في أن يكون العرض الأولي فارغًا. كحل بديل، يحتاج المستخدمون إلى التبديل إلى عرض الشهر، والعودة شهرًا واحدًا، ثم العودة إلى عرض القائمة لرؤية الأحداث السابقة.

موارد إضافية

• Discourse Calendar (and Event)
• Creating and managing events

[hellekin]

أواجه صعوبة في فهم كيفية إنشاء تقويم بحيث يظهر في فئة، وماذا أفعل لملئه بمجرد وجوده. بالنسبة للمواضيع، الأمر واضح جدًا، لكن حالة الفئة أكثر غموضًا. هل يمكن لأحد أن يقدم مثالاً؟

[hellekin]

إنشاء تقويم فئة

يختلف “تقويم الموضوع” عن “تقويم الفئة” في أن الأول يستخدم من استجابة موضوع معين، ويعرض التقويم في الموضوع نفسه، بينما يستخدم الأخير في أي موضوع في الفئة المكونة، ويعرض تقويم الأحداث في الفئة.

1. تمكين إضافة التقويم

في /admin/site_settings/category/discourse_calendar?filter=plugin%3Adiscourse-calendar → calendar categories:
تريد شيئًا مثل: categoryId=123;postId=4949;tzPicker;defaultView=month

• categoryId سهل العثور عليه: إنه الرقم الموجود في عنوان URL عند النقر على #category
• يمكن العثور على postId على النحو التالي: انتقل إلى وصف الفئة (الموضوع المثبت “حول الفئة”) وألحق .json بعنوان URL: postId في بداية ملف JSON.
• راجع وثائق discourse-calendar لـ الخيارات المتاحة.
• أضف الفئة (مرقمة 123 في مثالنا) إلى events calendar categories
  قد ترغب في تعيين discourse post event allowed on groups لتضمين المجموعات التي تريد أن تكون قادرة على إضافة أحداث.

2. إنشاء حدث

يمكنك إنشاء موضوع جديد في الفئة 123 و (من زر الترس).
سيظهر الحدث بعد ذلك في تقويم الفئة.

[jrgong]

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

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

[calendar defaultView=listNextYear fullDay=true]
[/calendar]

شاهد الخطأ أثناء العمل:

[Heliosurge (Dan DeMontmorency)]

أنا مهتم بهذه الوظيفة أيضًا.

أتساءل عما إذا كان قد تكون هناك أيضًا بعض نصوص مستكشف البيانات التي تتوافق مع البحث في التقويم.

[Ryan_Scott]

عندما ينشر شخص ما في مجتمعي حدثًا تقويميًا، ثم يقوم مسؤول بتحرير هذا الحدث، فلماذا لم يعد المنشئ الأصلي قادرًا على التحرير؟

هذه مشكلة كبيرة تؤثر على مئات الأشخاص.

[BetterSergio (Sergio)]

وضح أنه في الوقت الحالي يبدأ تقويم الموضوع يوم الاثنين فقط، وأن تقويم الفئة يبدأ يوم الأحد بدلاً من ذلك.

أود أن يكون هذا قابلاً للتكوين من قبل المسؤول، حيث يعرض كل منهما التقويم بشكل مختلف الآن…

[Сергей_Белошицкий]

أُفهم. هذا منطقي، لأنني لم أدرك–

[opcourdis]

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

شكرًا لك على هذا الدليل على أي حال، هناك الكثير لتغطيته لأن هناك العديد من الميزات وهو أمر رائع، عمل رائع للمطورين!

[JammyDodger]

@Discourse

لإضافة حدث إلى تقويم موضوع:

آه، أعاد الذكاء الاصطناعي كتابة بعض المصطلحات “الحدث”. من الناحية المثالية، يجب تجنب هذا المصطلح في النصف “التقويم” من المستندات حتى لا يتم إنشاء غموض مع ميزة “الحدث” الإضافية للمكون الإضافي.

[jerry_zen]

@Discourse

discourse-calendar

أريد أن أسأل أن الـ discourse الخاص بي لا يحتوي على زر التقويم والترس بعد تمكين المكون الإضافي، هل هناك خطأ ما؟

[Moin]

تم تغيير أيقونة الترس إلى منذ فترة. أعتقد أن إدراج التاريخ تم نقله إلى تلك القائمة المزيد (أعتقد أنها تستخدم أيضًا أيقونة الآن).

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

[jerry_zen]

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

[Moin]

هل يصلح الوضع الآمن موضع أيقونة الزائد؟

@jerry_zen

لا تقويم ولكن أحداث في القائمة

أي زر تقويم تتوقع؟

@Discourse

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

لإضافة حدث إلى تقويم الموضوع:

1. رد على الموضوع الذي يحتوي على التقويم
2. استخدم وظيفة إدراج التاريخ في المنشئ لإضافة تاريخ أو نطاق تاريخ
3. أضف وصفًا فوق التاريخ
4. أرسل الرد

هذا هو الآن

@Moin

[jerry_zen]

لدي زر الإدراج هذا، ثم كيف يمكنني نشر تقويم؟ لقد جربت الكود [calendar]، وهو يعمل، ولكن هل التاريخ/الوقت يشمل التقويم؟

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