 |
الملخص | إنشاء قوائم شريط جانبي مخصصة لمجموعات محددة |
 |
المعاينة | انضم إلى مجموعة منشئي السمات هذه، ثم قم بالمعاينة هنا |
 |
المستودع | https://github.com/Lillinator/discourse-group-sidebar-menus |
 |
دليل التثبيت | كيفية تثبيت سمة أو مكون سمة |
 |
جديد في سمات Discourse؟ | دليل المبتدئين لاستخدام سمات Discourse |
تثبيت مكون السمة هذا
نظرة عامة
يمنح مكون سمة Discourse هذا مشرفي المنتدى القدرة على إنشاء قوائم شريط جانبي مخصصة يمكن الوصول إليها فقط من قبل أعضاء مجموعات مختارة.
الميزات الرئيسية:
- ظهور القائمة بناءً على المجموعة - يتم عرض أقسام القائمة في الشريط الجانبي فقط للمستخدمين المصرح لهم.
- تكوين قائم على الكائنات - واجهة إعدادات سهلة الاستخدام لإنشاء القوائم.
- أقسام متعددة - إنشاء عدد غير محدود من أقسام القائمة لمجموعات مختلفة (ضمن حدود معقولة).
- رابط تعديل سريع للمشرف - يربط أيقونة القلم في رؤوس القوائم المشرفين مباشرةً بإعدادات المكون.
بعض حالات الاستخدام
- موارد وروابط سريعة مخصصة للموظفين فقط.
- اختصارات لمديري الأقسام.
- بوابات مخصصة للمجموعات (فرق المشاريع، مجموعات الدراسة، نوادي الكتب، الأعضاء المميزين VIP).
- روابط إلى موارد موقع الويب الأم أو الموقع الشريك.
الإعدادات
أقسام القائمة (menu_sections)
يفتح محرر إعدادات الكائن لتكوين أقسام قائمة المجموعة المخصصة.
خصائص القسم
| الخاصية | الوصف |
|---|---|
| عنوان القائمة | العنوان المعروض كرأس قسم الشريط الجانبي |
| المجموعات المسموح بها | المجموعات المسموح لها بعرض قسم القائمة هذا (الحد الأقصى: 20 مجموعة لكل قسم) |
| روابط القائمة | مجموعة من الروابط لعرضها في هذا القسم (الحد الأقصى: 20 رابطًا لكل قسم) |
خصائص الرابط
| الخاصية | الوصف |
|---|---|
| أيقونة | اسم أيقونة FontAwesome (على سبيل المثال، circle-info، star، user-group). قد تحتاج إلى إضافتها إلى Admin > جميع إعدادات الموقع > مجموعة أيقونات svg |
| النص | تسمية العرض للرابط |
| الرابط (URL) | وجهة الرابط - يدعم كلًا من المسارات النسبية (/faq، /my/preferences) وعناوين URL المطلقة (https://example.com) |
التثبيت والتكوين
- قم بتثبيت مكون السمة وفقًا لـ Installing a theme or theme component.
- انتقل إلى
محرر إعدادات الكائنات. - انقر فوق زر
+ new_menu_sectionلإعداد أول قسم قائمة مخصص. - امنح القائمة الجديدة عنوانًا في حقل
عنوان القائمة، ثم اختر المجموعات التي تريد منحها حق الوصول إليها. - انقر فوق
+ new_menu_sectionلإضافة قسم آخر، أو احفظ التغييرات.
لقطات شاشة لإعداد المشرف مع مثال على الإعداد
تثبيت جديد - انتقل إلى محرر إعدادات الكائنات.
سيناريو مثال مع قائمتين مخصصتين و3 مستخدمين، أحدهما مشرف:
@Catraتحب القطط وهي عضو في مجموعةpink، والتي سيكون لها حق الوصول إلىقائمة القطط@HelloKittyتحب الكلاب وهي عضو في مجموعةpurple، والتي سيكون لها حق الوصول إلىقائمة الكلاب@Lillyعضو في مجموعةpurpleلأنها تملك كلبًا والكلاب أفضل. ومع ذلك، فهي أيضًا مشرفة على المنتدى، وسيكون للمشرفين حق الوصول إلىقائمة القططلأن القطط تحتاج إلى إشراف أكبر
قم بإنشاء قائمة مخصصة جديدة - في مثالنا، قم بإنشاء قائمة القطط وأضف المجموعات المسموح لها بالوصول إليها - pink وadmins. ثم انقر فوق زر + menu_link لإعداد الروابط للقائمة الجديدة.
أضف روابط القائمة - 1. اسم أيقونة Fontawesome، 2. النص المراد عرضه للرابط، و 3. الرابط (URL)، نسبي أو مطلق. انقر فوق زر + menu_link لإضافة رابط آخر إلى هذه القائمة.
قم بإنشاء قسم قائمة مخصص آخر يسمى قائمة الكلاب، امنح المجموعة purple فقط حق الوصول وقم بتكوين الروابط:
لقطات شاشة للوصول إلى قائمة الشريط الجانبي الناتجة
المستخدم @Catra لديه قائمة القطط! 
المستخدم @HelloKitty لديه قائمة الكلاب!
المستخدم المشرف @Lilly لديه القوائمتين ويمكنه تحريرهما! 
مثال على التكوين
عنوان القائمة: "أشياء القطط"
المجموعات المسموح بها: team-cat
الروابط:
- أيقونة: link
نص: مقاطع فيديو وصور للقطط
رابط: /t/cat-videos-and-photos/123
- أيقونة: magnifying-glass
نص: ويكيبيديا القطط
رابط: https://en.wikipedia.org/wiki/Cat
ملاحظات هامة
وصول المشرفين
يجب على المشرفين إضافة أنفسهم إلى المجموعات لرؤية القوائم المخصصة لتلك المجموعات. لا يمنح وضع المشرف وحده الوصول إلى جميع القوائم المخصصة. هذا مقصود! أيضًا، سيشاهد المشرفون الذين ينتمون إلى المجموعات المسموح بها للقائمة أيقونة قلم في رأس القسم يربط بإعدادات المكون.
تكوين المجموعات
- لا يتم دعم مجموعة
everyone- استخدم واجهة المستخدم السفلية للشريط الجانبي الأصلية لإنشاء قوائم مخصصة عالمية لجميع المستخدمين، بما في ذلك الزوار المجهولين. - الحد الأقصى لعدد 20 مجموعة لكل قسم من أقسام القائمة. إذا كنت بحاجة إلى المزيد، قم بإنشاء أقسام مكررة بتعيينات مجموعات مختلفة.
- سيشاهد المستخدمون المنتمون إلى مجموعات متعددة جميع أقسام القائمة التي لديهم حق الوصول إليها.
الاختبار والتنظيم
استخدم حسابات الاختبار للتحقق من صحة الوصول لمختلف مجموعات المجموعات. احتفظ بسجل لتكوينات قوائمك لتجنب الارتباك مع تزايد التعقيد؛ يُنصح بمصفوفة وصول أو توثيق مشابه للمنتديات الكبيرة ذات المجموعات العديدة.
اعتبارات الأمان
يوفر هذا المكون تحكمًا في الوصول على مستوى واجهة المستخدم فقط. يتحكم في ظهور القائمة، وليس الوصول إلى الموارد - يتحكم هذا المكون فقط في ما يتم عرضه في الشريط الجانبي، وليس من يمكنه الوصول إلى الموارد الفعلية.
اعتمد دائمًا على نظام الأذونات المدمج في Discourse لتأمين الموارد الفعلية:
- قم بتكوين أذونات الفئة بشكل صحيح.
- اضبط قيود ظهور الموضوع.
- استخدم ضوابط الوصول القائمة على المجموعة للمحتوى.
- تأكد من أن الموارد الخاصة تتطلب المصادقة.
أفضل ممارسة للمشرفين:
قم بتكوين أذونات أمان الفئة المرتبطة وأعضاء المجموعة بشكل منفصل - على سبيل المثال: يجب أن يكون للرابط في القائمة إلى فئة خاصة أذونات تلك الفئة المكونة بشكل صحيح. يتحمل المشرفون مسؤولية التأكد من أن الروابط إلى الموارد الخارجية مصرح بها بشكل مناسب للمجموعات المختارة.
كان هذا مشروعًا تعاونيًا مع @Moin - كانت مساهمتها وإلهامها وتعليقاتها لا تقدر بثمن.
تصفح أشياء Discourse الأخرى الخاصة بي
) في لقطات الشاشة الخاصة بكما، تظهر قائمة القطط (Cat Menu) و قائمة الكلاب (Dog Menu) في شريط التنقل الجانبي فوق قسم المواضيع (Topics)، لكن قائمة مجموعتي المخصصة تظهر في أسفل شريط التنقل الجانبي الخاص بي. كيف يمكنني نقلها إلى الأعلى فوق المواضيع (Topics)؟