منظم فئات الشريط الجانبي

[Drew-ART (Drew)]

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

يوجد زر تبديل صغير في الأعلى حتى يتمكن المستخدمون من التبديل والاختيار أيهما يفضلون.

منظم فئات الشريط الجانبي

مكون سمة لـ Discourse ينظم فئات الشريط الجانبي في أقسام قابلة للطي ومُلونة وقابلة للتخصيص مع ميزات متقدمة.

الميزات

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

التثبيت

1. انتقل إلى المسؤول ← تخصيص ← السمات في مثيل Discourse الخاص بك
2. انقر فوق تثبيت ← من مستودع Git
3. أدخل: https://github.com/focallocal/sidebar-categories-organizer
4. انقر فوق تثبيت
5. أضف المكون إلى السمة النشطة لديك

الإعداد

الإعدادات العامة

• تمكين منظم الشريط الجانبي: تشغيل/إيقاف العرض المخصص
• إظهار زر التبديل: عرض أيقونة للتبديل بين طرق العرض (تظهر في رؤوس العرض المخصص والافتراضي)
• إظهار شارات الفئة: عرض المربعات الملونة بجوار أسماء الفئات
• استخدام التلاشي المتدرج: تمكين تأثير خلفية التدرج على رؤوس الأقسام (50% لون مصمت، 50% تلاشي إلى شفاف)
• الفئات المراد إخفاؤها: فواصل الفئات مفصولة بفواصل لإخفائها من جميع طرق العرض (على سبيل المثال، staff,private)
• العرض الافتراضي: اختر العرض الذي يتم تحميله افتراضيًا (مخصص أو افتراضي)

إعدادات القسم (1-10)

كل قسم يحتوي على:

• مُمكّن: تشغيل/إيقاف القسم
• العنوان: نص رأس القسم
• لون الخلفية: محدد الألوان لخلفية رأس القسم
• لون النص: محدد الألوان لنص الرأس
• الفئات: فواصل الفئات مفصولة بفواصل (على سبيل المثال، general,support,feedback)
• إظهار الفئات الفرعية: تبديل لإظهار/إخفاء الفئات الفرعية لهذا القسم
• مفتوح افتراضيًا: ما إذا كان القسم يبدأ موسعًا أم مطويًا

العثور على معرفات الفئات (Slugs)

معرفات الفئات موجودة في عنوان URL:

• yoursite.com/c/general/5 ← المعرف هو general
• yoursite.com/c/feature-requests/12 ← المعرف هو feature-requests

الاستخدام

بمجرد التثبيت والإعداد:

1. العرض المخصص: يتم تجميع الفئات في الأقسام المكونة لديك مع رؤوس ملونة
2. التوسيع/الطوي: انقر فوق رؤوس الأقسام لتبديل رؤية المحتوى
3. تبديل العروض: انقر فوق أيقونة في الرأس للتبديل بين العرض المخصص والافتراضي
   • في العرض المخصص: يظهر زر التبديل في رأس العرض المخصص
   • في العرض الافتراضي: يظهر زر التبديل في رأس “الفئات” الافتراضي
4. الفئات الفرعية: عند تمكينها لكل قسم، تظهر الفئات الفرعية مزاحة للداخل أسفل الفئات الرئيسية
5. شارات الفئة: المربعات الملونة الصغيرة (إذا تم تمكينها) تعرض لون كل فئة
6. الفئات غير المجمعة: أي فئات لم يتم تعيينها لأقسام تظهر في “فئات أخرى”
7. التفضيلات: يتم حفظ اختيار العرض وحالة الفتح/الإغلاق لكل متصفح

ميزات متقدمة

خلفيات متدرجة

عند التمكين، تستخدم رؤوس الأقسام تدرجًا سلسًا:

• 50% لون مصمت (لون الخلفية الذي اخترته)
• 50% تلاشي إلى شفاف
• يخلق مظهرًا عصريًا وأنيقًا

إخفاء الفئات

حدد معرفات الفئات لإخفائها تمامًا من الشريط الجانبي:

• مفيد للفئات الخاصة بالموظفين أو الفئات المهملة
• ينطبق على كل من العرض المخصص والافتراضي
• قائمة مفصولة بفواصل (على سبيل المثال، staff,private,archived)

الفئات الفرعية

• تبديل لكل قسم (وليس عام)
• عرض مزاح للداخل مع خط أصغر قليلاً
• شفافية مخفضة للتسلسل الهرمي البصري
• يحافظ على ألوان شارات الفئة

الإصدار

• الحالي: 1.0.1
• الحد الأدنى لـ Discourse: 3.3.0
• المؤلف: Andy@Focallocal

الترخيص

ترخيص MIT - راجع ملف LICENSE

الدعم

أبلغ عن المشكلات: GitHub · Where software is built

[Lilly (Lillian Louis)]

عمل رائع

نصيحة إعدادات الفئة

بدلاً من مطالبة المسؤولين بإدخال مسارات الفئات (slugs)، يمكنك استخدام هذا في ملف settings.yml الخاص بك، على سبيل المثال:

categories_to_hide:
  type: list
  list_type: category
  default: ""
  description:
    en: "Categories to hide from sidebar completely."

مما سيعطيك إعدادًا كهذا:

يمكنك أيضًا فعل الشيء نفسه مع المجموعات إذا أردت إنشاء قائمة منسدلة للمجموعات:

groups_this_setting_applies_to:
  type: list
  list_type: group
  default: ""
  description:
    en: "Groups this setting will apply to."

مما سيعطي شيئًا كهذا: