زر مراقبة فئة Discourse

النشر في Dev حاليًا، ولكن ربما يكون هذا مناسبًا لـ Theme component (وهو للقراءة فقط بالنسبة لي)

:discourse2: الملخص Watch Category Button يضيف عنصر span علامة يصبح زر “مراقبة هذه الفئة” في المشاركات.
:hammer_and_wrench: المستودع \u003chttps://github.com/pacharanero/discourse-watch-category-button\u003e
:open_book: جديد في سمات Discourse؟ دليل المبتدئين لاستخدام سمات Discourse

تثبيت مكون السمة هذا

\u003c!-- disabled

disabled –\u003e

\u003e :information_source: يستخدم مكون السمة هذا جلسة المستخدم المسجل الدخول لتحديث مستويات إشعارات الفئة؛ لا توجد مفاتيح API مطلوبة.

الميزات

  • إضافة زر “مراقبة هذه الفئة” داخل المشاركات باستخدام عنصر span آمن من التنقية.

  • يؤدي النقر على الزر إلى تعيين مستوى إشعار الفئة للمستخدم الحالي إلى مراقبة (Watching) إما للفئة الحالية أو للفئة المحددة بواسطة CategoryId.

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

  • يدعم استهداف معرف فئة محدد أو فئة المشاركة الحالية.

  • يتكامل مع وظيفة إشعارات المراقبة الحالية في Discourse، ولا يغير كيفية إدارة حالة المراقبة من قبل المستخدم في تفضيلاته، أو لكل فئة، أو في إلغاءات الاشتراك في إشعارات البريد الإلكتروني.

الاستخدام

تعيين فئة محددة

\u003cspan data-watch-category=\"3\"\u003eWatch this category\u003c/span\u003e

استخدام فئة المشاركة الحالية

\u003cspan data-watch-category=\"current\"\u003eWatch this category\u003c/span\u003e

النتيجة:

الإعدادات

لا يتضمن مكون السمة هذا إعدادات للسمة بعد. هذا هو التالي، بمجرد أن أتأكد من عدم وجود أخطاء رئيسية وأن مكون السمة هذا مفيد للآخرين.

اعتبارات الأمان والخصوصية

  • يمكن فقط لمستخدمي Staff إنشاء هذه الأزرار (في الوقت الحالي)
  • يتطلب نقرة صريحة من المستخدم لتغيير إعدادات الإشعار.
  • لا يتم استخدام مفاتيح API؛ يعتمد على الجلسة المسجلة الدخول.

أفكار خارطة الطريق

  • جعل المجموعات التي يمكنها إنشاء الأزرار قابلة للتكوين عبر إعدادات السمة.
  • جعل نمط الزر قابلاً للتكوين عبر إعدادات السمة.
  • جعل مستوى الإشعار قابلاً للتكوين (على سبيل المثال، تتبع، مراقبة، كتم).

المساهمة

يسعدني قبول المساهمات! يرجى فتح المشكلات أو طلبات السحب على مستودع GitHub. من الأفضل تحسين مكون السمة هذا بدلاً من نسخه لتغيير ALLOWED_GROUPS أو تغييرات طفيفة أخرى.

:discourse2: الملخص Watch Category Button يضيف عنصر span علامة يصبح زر “مراقبة هذه الفئة” في المشاركات.
:eyeglasses: المعاينة أضف لقطة شاشة/صورة متحركة هنا
:hammer_and_wrench: المستودع \u003chttps://github.com/pacharanero/discourse-watch-category-button\u003e
:open_book: جديد في سمات Discourse؟ دليل المبتدئين لاستخدام سمات Discourse

تثبيت مكون السمة هذا

\u003e :information_source: يستخدم مكون السمة هذا جلسة المستخدم المسجل الدخول لتحديث مستويات إشعارات الفئة؛ لا توجد مفاتيح API مطلوبة.

الميزات

  • إضافة زر “مراقبة هذه الفئة” داخل المشاركات باستخدام عنصر span آمن من التنقية.
  • يؤدي النقر على الزر إلى تعيين مستوى إشعار الفئة للمستخدم الحالي إلى مراقبة (Watching).
  • يتم تحويل المشاركات التي أنشأتها المجموعات المسموح بها فقط (الافتراضي: staff) إلى أزرار.
  • يدعم استهداف معرف فئة محدد أو فئة المشاركة الحالية.

الاستخدام

تعيين فئة محددة

\u003cspan data-watch-category=\"3\"\u003eWatch this category\u003c/span\u003e

استخدام فئة المشاركة الحالية

\u003cspan data-watch-category=\"current\"\u003eWatch this category\u003c/span\u003e

الإعدادات

لا يتضمن مكون السمة هذا إعدادات للسمة بعد. لتغيير من يمكنه إنشاء الأزرار، قم بتحرير:

  • ALLOWED_GROUPS في javascripts/discourse/api-initializers/theme-initializer.gjs

ملاحظات

  • يتطلب نقرة صريحة من المستخدم (لا توجد تغييرات صامتة).
  • التغيير يعكس سلوك قائمة إشعارات الفئة الأصلية.
  • يتم تحديث رأس صفحة الفئة عند الزيارة التالية دون تحديث كامل للصفحة.

المواضيع ذات الصلة

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

Change notification level with a link
Can I create a link to subscribe to a category? - #3 by david
Make watching a category more prominent for users
Notification setting button with context

3 إعجابات