يرجى تحسين توثيق إضافة Discourse Calendar

[mattdm (Matthew Miller)]

متابعةً للنقاش من تقويم Discourse — نظرًا لأن مشاركتي هناك ستُحذف تلقائيًا بعد شهر.

تحتاج المشاركة العلوية التي تصف هذه الإضافة إلى بعض العمل. إنها مربكة حقًا. تحديدًا:

الارتباك بشأن الأحداث

يبدو أن هناك ثلاثة أشياء منفصلة تسمى جميعًا “حدث”:

1. الأساسي: رد يحتوي على [date]، والذي يتم عرضه في تقويم في المشاركة الأولى في الموضوع.
2. مشاركة أولى في موضوع تحتوي على [event]، تُستخدم بواسطة الميزة الاختيارية “الحالة التجريبية” الموصوفة بشكل منفصل هنا.
3. إضافة منفصلة تمامًا باسم مشابه: أحداث بدلاً من حدث.

هذا… مربك.

صيغة غير واضحة للحدث الأساسي أحادي الموضوع

1. كيف يمكن تعيين اسم الحدث؟ وصف الإضافة يعرض نصًا يحتوي على أحداث، ولكن ليس كيف تم تعيين ذلك فعليًا.
2. كيف يمكن إنشاء أحداث متكررة؟
3. يعرض تقويم العطلات ألوانًا. هل يمكن أن يحتوي التقويم العادي على ألوان أيضًا، وإذا كان الأمر كذلك، فكيف؟
4. يمكن لميزة “الأحداث” المنفصلة إنتاج موجز ical على ما يبدو. هل يمكن لتقويم “أساسي” ذلك؟

المزيد من الأسئلة حول تقويم العطلات

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

إلخ…

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

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

شكرًا لك! هذه ميزة Discourse رائعة يمكن أن تكون مفيدة للغاية للكثير من الناس، ولكنها أيضًا مربكة للغاية.

[nathank (Nathan Kershaw)]

هذا المنشور عبارة عن ويكي - لذا يمكنك تقديم مساهماتك الخاصة إليه بسهولة. سيكون ذلك مفيدًا جدًا للجميع.

[mattdm (Matthew Miller)]

أستطيع، على الرغم من أن بعض الأشياء ستكون مجرد تخمينات!

[JammyDodger]

لقد رصدت هذا في المواضيع ذات الصلة أثناء تحديث مواضيع التقويم والفعاليات (فوز آخر للمواضيع ذات الصلة ).

لقد قمت بإعادة ترتيبها الآن بحيث تظهر كلتا الميزتين بشكل صحيح كموضوع إضافي واحد، مما قد يزيل بعض الارتباك:

Discourse Calendar (and Event)

Summary Discourse Calendar and Event adds dynamic and interactive calendar and event features to your Discourse site. Install Guide This plugin is bundled with Discourse core. There is no need to install the plugin separately. Enabling Calendar (and Event) The Calendar plugin can be enabled either by the toggle or from its settings, both accessible from your admin/plugins page: [/admin/plugins] Features Somewhat unsurprisingly, Discourse Calendar …

لقد قمت أيضًا بتقسيم الكثير من تفاصيل “كيفية” إلى دليلين لإعطائها بعض المساحة:

Creating and managing calendars

This guide explains how to create and manage calendars in Discourse using the Calendar (and Event) plugin. Required user level: All users Calendars are a powerful feature in Discourse that allow you to organize and display events within your community. This guide will walk you through the process of creating calendars, adding events, and managing them effectively. Summary Enable the Calendar plugin Create a calendar in a topic or category Add events to you…

Creating and managing events

This guide explains how to create and manage events using the Calendar (and Event) plugin in Discourse. It covers how to create events, set event options, interact with events, and view the upcoming events calendar. Required user level: All users (with appropriate permissions) Enabling events Events are a feature of the Calendar (and Event) plugin. To use this feature: Enable the Calendar (and Event) plugin Configure related settings For detailed instruct…

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

لكن نأمل أن نتحرك في الاتجاه الصحيح.