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