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

[Drew-ART (Drew)]

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

Install this theme component

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

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

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

الميزات

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

التثبيت

1. انتقل إلى Admin → Customize → Themes في مثيل Discourse الخاص بك
2. انقر على Install → From a Git repository
3. أدخل: https://github.com/focallocal/sidebar-categories-organizer
4. انقر على Install
5. أضف المكوّن إلى السمة النشطة لديك

الإعدادات

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

• Enable Sidebar Organizer: تشغيل/إيقاف العرض المخصص
• Show Toggle Button: عرض أيقونة للتبديل بين العروض (تظهر في رؤوس العرض المخصص والافتراضي)
• Show Category Badges: عرض مربعات ملونة بجوار أسماء الفئات
• Use Gradient Fade: تمكين تأثير خلفية التدرج على رؤوس الأقسام (50% لون صلب، 50% تلاشي إلى شفاف)
• Categories to Hide: قائمة مفصولة بفواصل لشرائح الفئات لإخفائها من جميع طرق العرض (على سبيل المثال، staff,private)
• Default View: اختر العرض الذي يتم تحميله افتراضيًا (مخصص أو افتراضي)

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

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

• Enabled: تبديل تشغيل/إيقاف القسم
• Title: نص رأس القسم
• Background Color: أداة اختيار اللون لخلفية رأس القسم
• Text Color: أداة اختيار لون نص الرأس
• Categories: قائمة مفصولة بفواصل لشرائح الفئات (على سبيل المثال، general,support,feedback)
• Show Subcategories: تبديل لإظهار/إخفاء الفئات الفرعية لهذا القسم
• Default Open: ما إذا كان القسم يبدأ موسعًا أم مطويًا

العثور على شرائح الفئات (Category Slugs)

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

• yoursite.com/c/general/5 → الشريحة هي general
• yoursite.com/c/feature-requests/12 → الشريحة هي feature-requests

الاستخدام

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

1. العرض المخصص: يتم تجميع الفئات في الأقسام المخصصة الخاصة بك مع رؤوس ملونة
2. التوسيع/الطوي: انقر على رؤوس الأقسام لتبديل رؤية المحتوى
3. تبديل العروض: انقر على أيقونة في الرأس للتبديل بين العرض المخصص والافتراضي
   • في العرض المخصص: يظهر زر التبديل في رأس العرض المخصص
   • في العرض الافتراضي: يظهر زر التبديل في رأس “Categories” الافتراضي
4. الفئات الفرعية: عند تمكينها لكل قسم، تظهر الفئات الفرعية مُزاحة للداخل أسفل الفئات الرئيسية
5. شارات الفئة: مربعات ملونة صغيرة (إذا كانت ممكّنة) تعرض لون كل فئة
6. الفئات غير المُجمَّعة: أي فئات غير مُعيَّنة لأقسام تظهر في “Other Categories”
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."

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

[jenmck (jen)]

أعجبني هذا حقًا وهو بالتأكيد شيء خطر ببالي، لذا شكرًا لك!

سؤال - إذا لم يكن لدى المستخدم إمكانية الوصول إلى أي فئات في قسم معين، فهل يظهر القسم نفسه للمستخدم؟

[NateDhaliwal]

نعم، يفعل ذلك:

javascripts%2Fdiscourse%2Fapi-initializers%2Fsidebar-organizer.js

[Drew-ART (Drew)]

لا، يتم إخفاء الفئة/الفئة الفرعية إذا لم يكن لديهم إذن بالوصول إليها. يمكنك أيضًا إخفاء أي منها يدويًا تختاره من خلال الإعدادات.

[Drew-ART (Drew)]

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

[Drew-ART (Drew)]

تم تحديث المكون الإضافي بمحددات منسدلة جميلة الآن.

[jenmck (jen)]

حسنًا، فهمت هذا الجزء - لكني أعني القسم الفعلي، وليس مجرد الفئة.

على سبيل المثال، إذا كان لدي هذا الإعداد:

الحيوانات

• القطط
• الكلاب

الغيوم

• السحاب الركامي
• السحاب الطبقي

الأيام

• السبت
• الأحد

لنفترض أن المستخدم ليس لديه إمكانية الوصول إلى فئتي السحاب الركامي أو السحاب الطبقي. هل سيظل قسم الغيوم يظهر للمستخدم ولكنه بدون فئات، كالتالي:

الحيوانات

• القطط
• الكلاب

الغيوم

الأيام

• السبت
• الأحد

أم أن قسم الغيوم لن يظهر على الإطلاق، كالتالي:

الحيوانات

• القطط
• الكلاب

الأيام

• السبت
• الأحد

[Drew-ART (Drew)]

إذا لم يكن لدى المستخدم إذن لعرض أي فئات في قسم ما، فسيتم إخفاء القسم بأكمله (علامة التبويب).

[Heliosurge (Dan DeMontmorency)]

هذا رائع جداً!

يجعلني أعيد التفكير في الأفكار هههه.

لقد كنت أفكر في استخدام إضافة تصنيفات المستندات (Doc Categories plugin) لتنظيم أقسام مخصصة بقوائم مركزة. ولكن أحتاج إلى تجميل للسماح بالألوان والأيقونات.

هناك ترميز ماركداون (markdown) لإضافة “تثبيت المكون” (Install component) إلى الخيار (Op).

هل تغير شيء في ميتا (Meta)؟ لا أستطيع تمييز شيء للاقتباس على أندرويد (Android) هنا. - حسناً، يبدو أنه تم حله.

[Heliosurge (Dan DeMontmorency)]

مرحباً ليلي، هل يمكننا الحصول على تنسيق ماركداون لـ “تثبيت المكون”

[NateDhaliwal]

إليك واحدًا لهذا المكون:

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

تنسيق Markdown (استبدل repoName و repoUrl):

[wrap=theme-install-button repoName="اسم المكون" repoUrl="رابط مستودع GitHub"]
تثبيت مكون السمة هذا
[/wrap]

[Heliosurge (Dan DeMontmorency)]

شكرًا نيت. حاولت البحث ولكن ربما كانت المصطلحات عامة جدًا.

[NateDhaliwal]

أوه، لست متأكدًا مما إذا كان مذكورًا في أي مكان. لقد أزلته من قالب موضوع Theme component .

[Heliosurge (Dan DeMontmorency)]

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