مراجعة سنوية لDiscourse

[Discourse]

	ملخص	ينشئ مراجعة سنوية لـ Discourse موضوعًا في الأول من يناير يلخص نشاط المنتدى في العام السابق. (شاهد أمثلة لدينا هنا في Meta - year-in-review)
	رابط المستودع	https://github.com/discourse/discourse-yearly-review
	دليل التثبيت	كيفية تثبيت الإضافات في Discourse

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

[ الدعم](Discourse Meta>%20قبل%20السؤال%2C%20هل%20بحثت%20أولاً%3F%20اضغط%20على%20​%20في%20الزاوية%20العلوية%20اليسرى%20للت البحث.)  خطأ  تجربة المستخدم  ميزة

الإعداد الأولي

انتقل إلى صفحة /admin/plugins الخاصة بك للضغط على زر إعدادات discourse-yearly-review الإعدادات:

1. أدخل الفئات لاستخراج البيانات منها في إعداد yearly review categories. إذا تُرك فارغًا، فسيكون الافتراضي هو أول 5 فئات عامة.

2. باستخدام إعداد yearly review publish category، اختر فئة وجهة للنشر فيها.

   يُوصى بشدة بتعيين yearly review publish category إلى فئة الموظفين أو أي فئة خاصة أخرى حتى تتمكن من عرض الموضوع قبل جعله عامًا. قد ترغب أيضًا في تعديله أولاً.

3. ثم، فعّل الإضافة باستخدام إعداد yearly review enabled.

الميزات

كما يمكنك رؤيته في 2022: The Year in Review يتم عرض البيانات في قسمين: المستخدمين والمواضيع.

يتضمن قسم المستخدمين:

• أكثر وقت للقراءة
• أكثر المواضيع إنشاءً
• أكثر الردود إنشاءً
• أكثر المواضيع التي تم الرد عليها
• أكثر الإعجابات الممنوحة
• أكثر الإعجابات المستلمة
• أكثر الزيارات
• المستخدمين الذين مُنحوا شارة مميزة (يتم تعيين الشارة من خلال إعداد الموقع yearly review featured badge)

يتضمن قسم المواضيع:

• الأكثر قراءة
• الأكثر إعجابًا
• الأكثر ردًا عليها
• الأكثر شعبية
• الأكثر حفظًا في العلامات المرجعية

إنشاء المراجعة السنوية

تقوم الإضافة بتعيين عتبات لتحديد المواضيع التي سيتم عرضها. يجب أن يكون هناك حد أدنى من 10 إعجابات أو ردود، أو 5 إشارات مرجعية، أو درجة 10، أو ساعة قراءة واحدة قبل عرض أي موضوع. يتم نشر الموضوع تلقائيًا عبر مهمة خلفية. تتحقق المهمة من أن الإضافة مفعلة وأن الوقت يقع ضمن أول 31 يومًا من الشهر الأول من السنة. ثم تتحقق لمعرفة ما إذا كان موضوع بعنوان yearly_review.topic_title قد نُشر بالفعل بواسطة مستخدم النظام. إذا مرت جميع الفحوصات، يتم نشر الموضوع في الفئة المحددة في إعداد yearly review publish category. إذا لم يتم تكوين هذا الإعداد، سيتم نشر الموضوع في فئة “غير مصنفة”.

خيارات إضافية

فئات المراجعة السنوية

الفئات المستخدمة في هذا القسم هي تلك المحددة في إعداد الموقع yearly review categories. إذا لم يتم تكوين هذا الإعداد، فسيتم اختيار أفضل 5 فئات عامة من المنتدى. يتم تحديد “الأفضل” بناءً على عدد topics_year للفئة.

لن تُدرج الفئات الفرعية لأي فئات محددة في إعداد الموقع yearly review categories في تقرير المراجعة السنوية. إذا كنت تريد إدراج الفئات الفرعية في تقرير المراجعة السنوية، فستحتاج إلى تحديدها صراحةً في إعداد الموقع yearly review categories.

استبعاد الموظفين في المراجعة السنوية

تحتوي الإضافة على إعداد yearly review exclude staff. وهو مفعّل افتراضيًا بحيث يتم استبعاد أعضاء الفريق من قسم المستخدمين، واستبعاد المواضيع التي أنشأها الموظفون من قسم المواضيع.

الشارة المميزة للمراجعة السنوية

يمكن تعيين شارة مميزة عبر إعداد yearly review featured badge. يتم عرض ما يصل إلى 15 مستخدمًا للشارة. إذا تم منح هذه الشارة لأكثر من 15 مستخدمًا، فسيتم عرض رابط لصفحة الشارة. إذا لم يتم تكوين yearly review featured badge، فلن يتم عرض هذا القسم.

تشغيل المراجعة السنوية يدويًا

إذا لم ترغب في انتظار المهمة الخلفية، يمكنك نشر الموضوع من وحدة تحكم rails باستخدام:

Jobs::YearlyReview.new.execute(force: true)

إذا كنت تريد إنشاء تقرير لسنة معينة، ففقط أضف review_year: 'year'، على سبيل المثال:

Jobs::YearlyReview.new.execute(force: true, review_year: '2021')

مستضافون معنا؟ إذا كنت ترغب في تشغيل المراجعة السنوية يدويًا، يمكنك الاتصال بنا على team@discourse.org وسنكون سعداء بترتيب ذلك لك.

الإعدادات

الاسم	الوصف
yearly review enabled	تمكين المراجعة السنوية.
yearly review categories	الفئات العامة لاستخراج المواضيع منها. سيتم اختيار أول 5 فئات من هذه المجموعة. إذا تُرك فارغًا، فسيكون الافتراضي هو أول 5 فئات عامة.
yearly review exclude staff	استبعاد الموظفين من إحصائيات المستخدمين.
yearly review include user stats	إضافة إحصائيات تعريفية للمستخدمين إلى المنشور الأول لموضوع المراجعة.
yearly review include private categories	تضمين نشاط المستخدم من الفئات الخاصة أو المقيدة بالقراءة في المراجعة.
yearly review publish category	الفئة التي سيتم نشر المراجعة فيها.
yearly review featured badge	أدخل اسم الشارة بالكامل. يمكن تركه فارغًا.

مستضافون معنا؟ هذه الإضافة متاحة في جميع مستويات استضافتنا Yearly Review | Discourse - Civilized Discussion

---

مشكلات معروفة

• يتم عرض البيانات في جداول HTML. يتم تغليف الجداول بعلامات div تحتوي على سمات data-review-topic-users="true" و data-review-featured-topics="true". يسمح هذا بتنسيق الجداول عند عرضها على Discourse. لا يتم نسخ الأنماط عند إنشاء رسائل البريد الإلكتروني للمواضيع. الرسائل المرسلة للموضوع لا تبدو رائعة.

• المنشور الأول في الموضوع المولد يحتوي على حوالي 40,000 حرف بسبب استخدام HTML. ونتيجة لذلك، لا يمكن تعديله ما لم تقم أولاً بزيادة حد أحرف الجسم فوق هذا الحد (انظر Body is limited to 32000 characters; you entered 43659)

• الرموز التعبيرية (emojis) في العناوين لا يتم عرضها في روابط المواضيع المميزة.

[Samantha_O]

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

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

[Ayelen_Rives (Aye Rives)]

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

[Aaron_Walsh]

تحياتي @Ayelen_Rives،

عند فحص لوحة التحكم الإدارية، ستُعرض لك المساعدة البصرية التالية:

المزيد من التدقيق داخل المكون الإضافي بعنوان ‘plugin:discourse-yearly-review’ يكشف عن مثال توضيحي آخر:

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

[Ayelen_Rives (Aye Rives)]

شكراً جزيلاً لك يا آرون!

بشكل غير متوقع، لا أرى تلك الرسائل في لوحة التحكم الإدارية، ولا في الإعدادات:

فئة النشر هي “الموظفون”، لذا سأكتشف في 1 يناير إذا تم إنشاؤها.

شكراً مرة أخرى وعطلة سعيدة!

[Roi]

سنة جديدة سعيدة!

لم يتم تشغيل المكون الإضافي هنا في منتدين. والآن يعرض الرسالة الخاصة بتاريخ 1 يناير 2025. غريب.

لقد قمت بتشغيله يدويًا في وحدة تحكم rails في أحد المنتديات وعاد باللغة الإنجليزية، وليس الألمانية، وهي لغة المنتدى.

هناك خطأ ما / كان هناك خطأ ما هنا.

[JammyDodger]

لم يصل إلى هنا على ميتا بعد أيضًا. لقد اتبعت النصيحة وقمت بتعيينه للنشر على #staff أولاً، وهو ما أعتقد أنه الاختلاف الوحيد عن العام الماضي؟

كنت آمل أن يظهر بشكل سحري مع قليل من الصبر، لكن ربما أكون متفائلاً.

[Roi]

لم أقم بتغيير أي شيء في الإعدادات، حتى المنتدى للتحقق منه أولاً كعضو في فريق العمل ثم نقله،

في منتداي الثاني لا يوجد شيء بعد. والساعة الآن 11:24 صباحًا لدي.

يبدو أن هناك خطأ ما.

هل هناك حاجة لعلم لغة عند تشغيله يدويًا؟ لا أريد ترجمة كل شيء في المنتدى الثاني أيضًا.

[JammyDodger]

قد أكون مغريًا لترك الأمر لفترة أطول لمعرفة ما إذا كان هناك تأخير في المهمة الخلفية، لكنني لست متأكدًا أيضًا من سبب إعطاء تشغيلها يدويًا نتيجة مختلفة عن تشغيل المهمة الخلفية بنفسها؟

قد نحتاج إلى شخص أكثر معرفة للمساهمة.

[packman (Chris McMahon)]

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

[Jagster (Jakke Flemming)]

صباح اليوم تقريبًا، أخبرني sidekiq أن المراجعة السنوية ستتم جدولتها في غضون 50 دقيقة، وفي الوقت الحالي سيكون ذلك حوالي الساعة 11 صباحًا بالتوقيت المحلي. لم أنتظر، على الرغم من ذلك، وقمت بذلك يدويًا. لم تكن هناك مشاكل وكانت اللغة صحيحة أيضًا.

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

حسنًا، هذه قصة مختلفة، ولكن هل يمكن أن يكون لدينا المزيد من الحرية في تضمين أو استبعاد المجموعات؟

[Roi]

يا إلهي… في المنتدى الآخر، يوجد موضوع 2023… الساعة 2:31 مساءً بالتوقيت المحلي. وباللغة الألمانية. لذا، لا يزال غامضًا…

[JammyDodger]

لقد قمت بتشغيل نظامنا من Sidekiq في النهاية.

2023: The Year in Review

2023's Top Users Most Time Reading User Hours Read [avatar] @Canapin 294 [avatar] @Don 233 [avatar] @Moin 186 [avatar] @merefield 158 [avatar] @pfaffman 139 [avatar] @simon 127 [avatar] @Arkshine 118 [avatar] @Jagster 117 [avatar] @ClawdiaWolf 82 [avatar] @Heliosurge 69 Most Topics User Topics [avatar] @twofoursixeight 84 [avatar] @jordan-violet 69 [avatar] @Don 67 [avatar] @danielabc 65 [avatar] @Jagster 62 [avatar] @jidanni 62 [avatar] @Cana…

[tobiaseigen]

على مواقعي، تم إنشاء الموضوع دون الحاجة إلى تشغيله يدويًا في sidekiq.

@Samantha_O

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

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

في هذه الأثناء، لهذه الجولة، يمكنك تعديل المنشور بمجرد نشره كما تراه مناسبًا.

أحد السلوكيات المثيرة للاهتمام التي لاحظتها هو أنه إذا قمت بحذف الموضوع الذي تم إنشاؤه، فسيتم إنشاء موضوع جديد في اليوم التالي، طالما أن المكون الإضافي ممكّن. لذلك يمكنك اللعب بالإعدادات وإنشاء إصدارات متعددة من موضوع المراجعة السنوية، ونسخ النص منها، ثم نشر مواضيع جديدة بنفسك كما تراه مناسبًا. إذا كان لديك وصول إلى /sidekiq، يمكنك العثور على المهمة هناك وتشغيلها على الفور.

[Jagster (Jakke Flemming)]

@tobiaseigen

إذا قمت بحذف الموضوع الذي تم إنشاؤه

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

ليس بالأمر الكبير، مع ذلك.

[Ayelen_Rives (Aye Rives)]

@Ayelen_Rives

سأكتشف في الأول من يناير ما إذا كان قد تم إنشاؤه.

مرحباً! لحسن الحظ، قام المكون الإضافي بتشغيل نفسه في الأول من يناير دون أي مشكلة!

أنا الآن لدي بعض الأسئلة حول كيفية عمله لأن بعض التقارير (مثل “أكثر المواضيع” و “أكبر عدد من الإعجابات المقدمة”) تظهر نتائج مختلفة عن صفحة المستخدمين لنفس الفترة.

على سبيل المثال، بالنسبة لـ “أكثر المواضيع”، تظهر صفحة المستخدمين أولاً المستخدم “S”:

ويظهر الاستعراض السنوي أولاً المستخدم “C” ولا يظهر المستخدم “S” أبداً في الجدول:

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

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

شكراً جزيلاً لمساعدتكم!

[tobiaseigen]

@Jagster

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

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

خطوات التكرار:

1. بمجرد إنشاء موضوع المراجعة السنوي، انقله إلى فئة مختلفة
2. قم بتشغيل إنشاء موضوع المراجعة السنوي عبر /sidekiq
3. يتم إنشاء موضوع المراجعة السنوي الثاني.

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

[ganncamp (G Ann Campbell)]

@tobiaseigen

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

ما مدى استمراريته؟ إذا واصلت حذفه، فهل سنظل نرقص في يونيو؟

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

[Jagster (Jakke Flemming)]

@ganncamp

ما مدى استمراريته؟

حقًا. إنه يعمل عبر Sidekiq كل يوم.

[Moin]

@جي آن كامبل، مشاركة: 158، موضوع: 105713، اسم المستخدم: ganncamp

إذا واصلت حذفه، هل سنظل نقوم بالرقص في يونيو؟

آمل أن يتوقف في نهاية يناير.

The Yearly Review plugin keeps creating new topics

Thanks for following up on this. Relying on the topic’s title to prevent creating multiple review topics is a really flaky approach (that’s my fault.) Once January ends, the issue won’t come up again until next year. @JammyDodger, maybe you could pass a note to the Discourse team to look into coming up with a better way of preventing multiple topics from being created. That should get done before January 2024. Time sure flies