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

[Discourse]

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

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

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

ملخص

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

تمكين المكون الإضافي Calendar

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

إنشاء تقويم

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

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

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

2. أضف الرمز التالي على أسطر منفصلة:

   [calendar]
   [/calendar]
   

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

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

تقويم الفئة

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

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

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

   categoryId=123;postId=4949;tzPicker;defaultView=month
   

   • استبدل 123 بمعرف الفئة الخاص بك (موجود في عنوان URL عند عرض الفئة)
   • استبدل 4949 بمعرف المنشور لوصف الفئة (يتم العثور عليه بإلحاق .json بعنوان URL لموضوع “About category”)

3. أضف معرف الفئة إلى إعداد “events calendar categories”

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

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

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

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

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

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

تقويم الفئة

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

1. أنشئ موضوعًا جديدًا في الفئة
2. انقر فوق زر الترس واختر “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]، وهو يعمل، ولكن هل التاريخ/الوقت يشمل التقويم؟

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