إعادة ترتيب قائمة الشريط الجانبي في Discourse

[Lilly (Lillian)]

	الملخص	يسمح بإعادة ترتيب أقسام القائمة الجانبية الافتراضية والمخصصة
	معاينة	https://discourse.theme-creator.io/theme/Lilly/discourse-sidebar-menu-reorder
	المستودع	https://github.com/Lillinator/discourse-sidebar-menu-reorder
	دليل التثبيت	كيفية تثبيت سمة أو مكون سمة

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

المقدمة

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

نظرة عامة

يتيح مكون السمة هذا لمسؤولي Discourse إعادة ترتيب أقسام القائمة الجانبية الخاصة بمنتداك في واجهة المستخدم الخاصة بالمسؤول، بما في ذلك جميع الأقسام الافتراضية بالإضافة إلى أي أقسام مخصصة مرئية عالميًا.

يعمل المكون مع عروض القائمة الجانبية على سطح المكتب والجوال، وكذلك مع وضع القائمة المنسدلة في الرأس (على الرغم من أنه مصمم بشكل مثالي لوضع القائمة الجانبية).

---

التثبيت & التكوين

• قم بتثبيت مكون السمة هذا وفقًا لـ دليل المبتدئين لاستخدام سمات Discourse.
• يشير القسم community إلى القسم العلوي الافتراضي للقائمة الجانبية - القائمة التي تحتوي على رأس المواضيع وتشمل القائمة الفرعية المنسدلة المزيد؛ يُنصح بعدم نقل أكثر من قسم أو قسمين (افتراضي أو مخصص) فوق قسم community.
• لا تحذف أيًا من الأقسام الافتراضية في الإعداد، وإلا ستخرج عن الترتيب (يمكنك دائمًا إضافتها مرة أخرى أو إعادة تعيين الإعداد).
• أفضل طريقة لتكوين هذا المكون هي أن يكون لديك شاشة إعدادات المكون مع قائمة إعادة الترتيب في نافذة متصفح واحدة، وعرض القائمة الجانبية للمنتدى كمستخدم تجريبي في نافذة أخرى بجانبها؛ قم بتحديث الصفحة بعد كل تغيير في ترتيب قسم القائمة في القائمة.

---

الإعدادات

الإعداد	الوصف
Sidebar menu order	إعداد قائمة يحتوي على أقسام القائمة الافتراضية. (community هو القسم العلوي الافتراضي في القائمة الجانبية ويشمل القائمة المنسدلة More.) أعد ترتيب أقسام القائمة باستخدام أسهم الأعلى والأسفل على الجانب. يمكن إضافة الأقسام المخصصة المرئية عالميًا أيضًا - استخدم اسم القسم (على سبيل المثال، لقائمة مخصصة بعنوان قائمة الاختبار، أضف test-menu في الإعداد).

يحتوي مكون السمة في البداية على الإعدادات الافتراضية. يحتاج المسؤولون إلى إضافة أي أقسام قائمة مخصصة عالمية يرغبون في دمجها في قائمة الترتيب، ثم إعادة ترتيبها مع الأقسام الافتراضية.

لقطة شاشة لإعدادات المكون الافتراضية

---

لقطات الشاشة

تظهر لقطات الشاشة أدناه قسم community، وقسمين مخصصين للقائمة كمثالين يُسميان “روابط المطورين” (dev-links) و"علبة الأدوات" (toolbox) كما تظهر في لوحة تحكم المكون على اليسار، وللمستخدم العادي على اليمين. تُظهر الأسهم الموجودة في المربع الأحمر الصغير كيفية تحريك قسم القائمة للأعلى والأسفل في إعدادات المكون.

---

هنا، تم تكوين الإعداد لإظهار قسم categories الافتراضي فوق قسم community (في وضعي الانكماش والتمدد):

إليك مثال باستخدام قسمين مخصصين: أحدهما يُسمى dev-links ويقع فوق قسم community الافتراضي، والآخر يُسمى toolbox ويقع أسفل قسم tags الافتراضي.

أيضًا، لاحظ القسم المسمى inbox-section في لقطة شاشة المسؤول أعلاه - هذا هو قسم الرسائل الذي يقوم مكون قسم الرسائل للقائمة الجانبية بإدراجه في القائمة الجانبية (تحت القائمة المخصصة toolbox أعلاه)، مما يظهر أن هذا المكون يمكن استخدامه لنقله أيضًا.

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

---

ملاحظات

• بعد إضافة أقسام مخصصة عالمية جديدة إلى إعداد sidebar_menu_order، س يرى مستخدمو المنتدى الترتيب الصحيح الجديد للقائمة عند إعادة تحميل متصفحهم أو طي/تمديد القائمة الجانبية.
• إنشاء أقسام قائمة مخصصة عالمية جديدة بينما يكون هذا المكون مفعّلًا قد يؤدي إلى ظهور أقسام مكررة مؤقتة للمسؤول حتى يتم إعادة عرض القائمة الجانبية، إما عن طريق تحديث الصفحة أو عن طريق طيها وتمديدها.
• ستظهر دائمًا أقسام القائمة المخصصة التي ينشئها المستخدم في أسفل القائمة الجانبية لذلك المستخدم، ولكنها غير متأثرة بغير ذلك.
• إذا تم تعيين إعداد Admin -> All Site Settings -> Chat Separate Sidebar Mode على Always، فسيظهر زر الدردشة كالمعتاد في الأسفل، وسيغفل المكون أقسام قائمة الدردشة الافتراضية (chat-dms، chat-channels، وchat-search).

---

تصفح أعمالي الأخرى في Discourse

[David_Ghost]

إنه رائع حقًا. أحب حقًا استخدام إعداد الفئات (1) ثم الدردشة (2). شكرًا جزيلاً لك على عملك الرائع يا ليلي.

[R23D_Printing]

هل ما زال هذا مدعومًا؟ حاولت التثبيت وحصلت على الخطأ التالي. لقد حاولت من هنا وكذلك باستخدام التعليمات اليدوية.

[Moin]

نعم، هذا صحيح. الرابط الموجود في زر “تثبيت مكون السمة هذا” قديم، لكن الرابط في الأعلى لا يزال صحيحًا ويمكنك استخدامه لتثبيت المكون يدويًا

أو جرب هذا الزر

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

[nathank (Nathan Kershaw)]

لقد قمت للتو بتصحيح الرابط في زر التثبيت في المنشور الأصلي (OP) لذا كل شيء على ما يرام الآن.

[nathank (Nathan Kershaw)]

لقد صادفت خطأً بسيطًا، حيث أن الترتيب المحدد لا يعمل عندما تكون شاشة “سطح المكتب” ضيقة بشكل غير عادي - كما هو الحال على هاتفي القابل للطي.

هكذا أريده أن يبدو:

   

عندما تكون لدي شاشة ذات حجم غريب (يبدو أن العرض يتراوح بين 640-820 تقريبًا)، أفقد الترتيب:

[Lilly (Lillian)]

يا إلهي، عودة الشريط الجانبي ذي العمودين. اعتقدت أن هذا الشيء قد اختفى؟ سألقي نظرة…

[nathank (Nathan Kershaw)]

لقد كنت أنا بالفعل غبياً بعض الشيء! كنت أستخدم المكون القديم ولم ألاحظ ذلك حتى.

ومع ذلك، لاحظت شيئًا واحدًا - ما كان يسمى community أصبح يسمى الآن the-forum. إليك طلب سحب (PR) لتنظيف ذلك في الإعدادات الافتراضية:

Update settings.yml (#3)

[Moin]

@nathank

ما كان يسمى community يسمى الآن the-forum بدلاً من ذلك

في المنتدى الخاص بي لا يزال يسمى community وهنا في ميتا أيضًا.

أتساءل كيف قمت بتغييره.

[nathank (Nathan Kershaw)]

هذا غريب بالفعل! أتذكر أنني غيرت النص عليه في مرحلة ما عندما أفكر في الأمر الآن. لكنني لست متأكداً كيف وصل ذلك إلى HTML!

سأقوم بسحب طلب السحب (PR) هذا وأفكر ملياً. قد يظل الأمر “غرابة” في موقعي!

[Lilly (Lillian)]

يجب أن تكون قادرًا على تنفيذ بعض أوامر rails لإعادة تسميته. إذا كان القسم الخاص بك يسمى بالفعل the-forum، فأعتقد أن هذا يجب أن يعمل من وحدة تحكم rails:

cd /var/discourse
./launcher enter app
rails c

section = SidebarSection.find_by(title: 'the-forum', public: true)
if section
  section.update!(title: 'community')
  puts "تم: تمت إعادة التسمية إلى 'community'."
else
  puts "لم يتم العثور على القسم."
end

تأكد من عمل نسخة احتياطية أولاً.

[nathank (Nathan Kershaw)]

لقد جربت هذا (أخيرًا). لكنه لم يعثر على القسم:

أعتقد أن هذا قد يظل مجرد غرابة في الموقع، أليس كذلك؟

[Lilly (Lillian)]

(حذف المنشور من قبل المؤلف)

[Lilly (Lillian)]

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