قسم الرسائل للشريط الجانبي

[Moin]

	ملخص	إضافة روابط لصندوق الرسائل الشخصية والجماعية إلى الشريط الجانبي، بما في ذلك مؤشرات الرسائل غير المقروءة
	معاينة	Theme Creator
	المستودع	GitHub - moin-Jana/sidebar-messages-section: Adds personal and group message inbox links to the sidebar, including unread message indicators. · GitHub
	دليل التثبيت	كيفية تثبيت سمة أو مكون سمة
	جديد في سمات Discourse؟	دليل المبتدئين لاستخدام سمات Discourse

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

يضيف المكون قسم الرسائل إلى الشريط الجانبي مع روابط لصناديق الرسائل الشخصية - سواء صندوق المستخدم الشخصي أو أي صناديق جماعية لديه صلاحية الوصول إليها. يتضمن القسم أيضًا زرًا لكتابة رسالة شخصية جديدة بجانب عنوان القسم.

الصندوق الشخصي

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

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

الصناديق الجماعية

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

يتيح إعداد منفصل، use_group_page_inbox، اختيار ما إذا كانت روابط الصناديق الجماعية تفتح في واجهة رسائل المستخدم (/my/messages/group/{group_name}) أو في صفحة المجموعة (/g/{group_name}/messages/inbox).

مؤشر غير المقروء

يُظهر كل رابط صندوق حالة الرسالة الحالية بناءً على تفضيل المستخدم لـ “إظهار عدد العناصر الجديدة”: إما نقطة أو العدد الرقمي. تُعرض القيم فوق 100 على شكل 99+.

إعدادات متقدمة للصناديق الجماعية

لتخصيص ترتيب الصناديق الجماعية أو تغيير الاسم المعروض في الشريط الجانبي، يمكنك استخدام إعداد advanced_group_inbox_configuration.

في هذا الإعداد يمكنك:

• اختيار مجموعة من القائمة المنسدلة
• تحديد اسم مخصص اختياريًا سيظهر في الشريط الجانبي
• إعادة ترتيب المجموعات المهيأة باستخدام الأزرار في الأسفل

الاسم المخصص مفيد أيضًا داخل الإعداد نفسه.
إذا لم يتم توفير اسم، سيتم تسمية الإدخال باسم مجموعة 1، مجموعة 2، إلخ. (بناءً على موقعها). إضافة اسم مؤقت يمكن أن يسهل إعادة الترتيب، ويمكنك إزالته مرة أخرى قبل الحفظ إذا أردت.

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

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

يمكنك رؤية مثال على التكوين وكيف يؤثر على الترتيب والأسماء المعروضة في لقطات الشاشة أدناه:

موقع قسم الرسائل

لتغيير موقع قسم الرسائل، يمكنك إما استخدام CSS، على سبيل المثال

@nathank

/* التأكد من ظهور قسم الرسائل أولاً في حاوية الفليكس بوكس */
.sidebar-section-wrapper {
  order: 1;
}
.sidebar-section-wrapper[data-section-name="inbox-section"] {
  order: 0;
}

بدلاً من ذلك، يمكنك تثبيت مكون Discourse Sidebar Menu Reorder واستخدام inbox-section كاسم القسم عند تعديل موقعه. يمكنك أيضًا استخدام إعداد الترتيب في مكون Navigation (sidebar) menu display control.

[Lilly]

رائع، أحسنت يا موين!

[NateDhaliwal]

اقتراح بسيط: ربما يجب أن يكون الملف javascripts/discourse/api-initializers/group-inboxes-in-sidebar.gjs ملف JS بدلاً من GJS؟

مكون رائع!

---

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

[Moin]

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

[putty (Derek Putnam)]

@Moin

لتجنب الروابط المكررة إلى صندوق الوارد الشخصي، قد ترغب في إزالة رابط الرسائل في القسم الأول من الشريط الجانبي.

لم أتمكن من العثور على إعداد مسؤول لهذا، لذا هذا إعلان عام (PSA) سيخفيه عبر CSS:

.sidebar-section-link[data-link-name="my-messages"] {
    display: none;
}

[Moin]

لماذا تفضل إخفاء الرابط باستخدام CSS بدلاً من استخدام الخيار الحالي للمسؤولين لتخصيص الشريط الجانبي؟ يبدو أن الإخفاء باستخدام CSS أكثر عرضة للتعطل من استخدام خيارات Discourse المضمنة.

@Moin

لتخصيص هذا القسم:

1. انقر على المزيد في الشريط الجانبي
2. حدد تخصيص هذا القسم في أسفل القائمة الممتدة

[putty (Derek Putnam)]

ديرب، أنت على حق. كنت أُفرط في التفكير، معتقدًا أنها ستكون إعدادًا في وحدة التحكم الإدارية و/أو وظيفة أساسية.

[Heliosurge (Dan DeMontmorency)]

لست الوحيد الذي كان يبحث هناك.

---

هذا مكون رائع!

[Moin]

لقد قمت بتوسيع الملاحظة:

@Moin

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

[Heliosurge (Dan DeMontmorency)]

نعم فعلت. ولكن بصفتنا مسؤولين، غالبًا ما نعتاد على المرور عبر لوحة المسؤول. . لذلك عند تصفح التعليمات، قد نتغاضى عن بعض التفاصيل.

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

منذ زمن بعيد مع نظام أندرويد على سبيل المثال، إذا كنت أتذكر، كان Gingerbread يحتوي على Nav (التنقل) و Maps (الخرائط). قضيت حوالي 10 دقائق في البحث عن Nav بعد أن دمجوه مع Maps في تحديث.

[nathank (Nathan Kershaw)]

هذا مكون سمة رائع يناسب المواقع التي تعتمد بشكل كبير على الرسائل! شكرًا لـ @moin على عملك الممتاز!

لجعله أفضل لأولئك الذين يستخدمون المجموعات كثيرًا (الرسائل هي مكون كبير في ذلك)، هل تمانع في النظر في هذه الاقتراحات؟

موضع قابل للتحديد في الشريط الجانبي

للتأكيد على الرسائل بشكل أكبر في واجهة المستخدم، أود أن تكون في الجزء العلوي من الشريط الجانبي (أي مباشرة تحت الروابط). في الأساس، أريد أن يتمكن الأشخاص من رؤية رسائلهم الأخيرة (لكل مجموعة) بسهولة في لمحة دون الاعتماد على الإشعارات.

لقد استخدمت CSS هذا لتحقيق ذلك، لكنني أشك في أنني لست الوحيد الذي سيكون هذا مفيدًا له:

/* تأكد من ظهور قسم الرسائل أولاً في حاوية flexbox */
.sidebar-section-wrapper {
  order: 1;
}
.sidebar-section-wrapper[data-section-name="inbox-section"] {
  order: 0;
}

افتح صناديق البريد الوارد للمجموعات في سياق المجموعة

أريد أن يتمكن المستخدمون من العثور بسهولة على مجموعاتهم والتفاعل معها. من المنطقي بالنسبة لي أن يعملوا مع الرسائل في صندوق الوارد الذي يتم الوصول إليه من صفحة المجموعة (أي /g/the-group/messages/inbox) بدلاً من صفحة صندوق الوارد الشخصي الخاصة بهم (أي /my/messages/group/the-group)

هذا يمنحهم صفحة نظيفة تتمحور حول المجموعة، مع سهولة الوصول إلى أعضاء المجموعة والإعدادات الأخرى:

سيكون من الرائع أن يتم تنظيم هذا بواسطة إعداد في مكون السمة (TC).

[Moin]

@nathank

سيكون من الرائع أن يتم تنظيم هذا بواسطة إعداد في TC.

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

أعتقد أن الموضع الحالي هو نفسه قسم الرسائل الذي كان في النواة.
يوجد بالفعل مكون رائع حول تغيير ترتيب الأقسام في الشريط الجانبي: Navigation (sidebar) menu display control
لتجنب التعارضات لأن كلا المكونين يحاولان تجاوز الترتيب، قد يكون من المنطقي أن يستخدم المسؤولون الذين يريدون ترتيبًا مختلفًا المكون الحالي (أكد المؤلف أنه يعمل باستخدام “inbox-section” كاسم للقسم).
سيتعين علي أن أرى ما إذا كان بإمكاني تقديم إعداد إضافي لهذا. على أي حال، أريد تجنب تداخل المكونات مع بعضها البعض.

[nathank (Nathan Kershaw)]

@Moin

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

لقد كنت أعبث بهذا في شوكتي، ووجدت الشيء نفسه. إنه يعمل، ولكنه يفقد كلاً من مؤشر الرسائل غير المقروءة وتمييز الرابط في الشريط الجانبي. كلا الأمرين لهما قيمة عالية بالفعل!

لقد قمت بطلب سحب (PR) لما وصلت إليه:

Add group page inbox as an option

ولكن لكي ينجح الأمر حقًا، فإنه يحتاج حقًا إلى عمل مؤشر الرسائل غير المقروءة وتمييز الرابط، أليس كذلك؟

@Moin

هناك بالفعل مكون رائع حول تغيير ترتيب الأقسام في الشريط الجانبي: التحكم في عرض قائمة التنقل (الشريط الجانبي)

نقطة جيدة! هذه فكرة أفضل بكثير. ويا للخزي، أنا في الواقع أحد مؤلفي TC هذا!

[Moin]

لماذا استخدمت href بدلاً من route؟ أعتقد أن href لم يعمل مع مؤشرات عدم القراءة على الإطلاق. كنت أكثر قلقًا بشأن أن الأرقام الموجودة على المسار group.messages.inbox لم تكن متاحة بالطريقة التي يمكنك بها استخدامها في userPrivateMessages.

[nathank (Nathan Kershaw)]

لأنني مطور غير كفء، جربت العديد من الأشياء حتى نجح أحدها! ربما يعود ذلك أيضًا لاعتمادي غير الصحي على ذكاء اصطناعي توليدي ليس ذكيًا جدًا .

حاولت استخدام المسارات (routes)، لكنني لم أستطع فعليًا تجاوز المسارات الموجودة. لذا استسلمت.

تساءلت عما إذا كان من الممكن الحصول على تلك الأرقام/السلوكيات ببساطة عن طريق اختطاف الرابط للانتقال إلى موقع مختلف. لكن هذا معقد بعض الشيء بالنسبة لشخص عادي مثلي.

لا تتردد في “تحسينه”!

(بالمناسبة، قام @moin الرائع بذلك بالضبط، بإضافة الوظيفة وجعلها تعمل بشكل صحيح!)

[nathank (Nathan Kershaw)]

@Moin

أعتقد أن الموضع الحالي هو نفسه قسم الرسائل الذي كان في النواة (core).
هناك بالفعل مكون رائع حول تغيير ترتيب الأقسام في الشريط الجانبي: التحكم في عرض قائمة الشريط الجانبي للتنقل
لتجنب التعارضات لأن كلا المكونين يحاولان تجاوز الترتيب، قد يكون من المنطقي أن يستخدم المسؤولون الذين يريدون ترتيبًا مختلفًا المكون الحالي (أكد المؤلف أنه يعمل باستخدام “inbox-section” كاسم للقسم).

هذا يعمل بشكل جيد بالفعل. ومن المثير للإحراج بعض الشيء، أنني أحد مؤلفي هذا المكون الإضافي (ثانوي جدًا لـ @lilly) !

سيكون من الرائع وجود هذا في المنشور الأصلي (OP).

[Moin]

طلب @nathank خيارًا لتغيير ترتيب صناديق البريد الواردة للمجموعات في الشريط الجانبي. لقد طلبت سابقًا أفكارًا حول أفضل طريقة للتعامل مع هذا في https://meta.discourse.org/t/configuring-the-order-of-groups-in-theme-component-settings/391101، وأعتقد أنني توصلت الآن إلى حل.
لقد جمعت هذا مع طلب عرض الاسم الكامل للمجموعة بدلاً من اسمها المختصر. نظرًا لأن الاسم الكامل ليس متاحًا بسهولة في هذا السياق، فإن الحل هو السماح للمسؤولين بتعريف “اسم عرض مخصص” بدلاً من ذلك. الحقل الذي كان سيُستخدم سابقًا فقط لعرض اسم المجموعة في الإعدادات يُستخدم الآن أيضًا للتحكم في الاسم المعروض في الشريط الجانبي.

يتم التعامل مع كلتا الميزتين عبر الإعداد الجديد advanced_group_inbox_configuration.

في هذا الإعداد، يمكنك:

• تحديد مجموعة من قائمة منسدلة
• تحديد اسم مخصص اختياري سيتم عرضه في الشريط الجانبي
• إعادة ترتيب المجموعات المكونة باستخدام الأزرار الموجودة في الأسفل

الاسم المخصص مفيد أيضًا داخل الإعداد نفسه.
إذا لم يتم توفير اسم، سيتم تسمية الإدخال باسم group 1، group 2، وما إلى ذلك (بناءً على موضعه). يمكن أن يجعل إضافة اسم مؤقت عملية إعادة الترتيب أسهل، ويمكنك إزالته مرة أخرى قبل الحفظ إذا أردت.

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

في هذا المثال، لم يتم إدخال اسم مخصص لمجموعة المشرفين، ولهذا السبب تظهر باسم group 1 في التكوين. المجموعات الأخرى لها أسماء مخصصة.

ينتج عن هذا التكوين:

هنا يمكنك أن ترى أن صناديق البريد الواردة ‘doggo-daily’ و ‘cat_pics’ قد تبادلت المواقع وتظهر بدون واصلات أو شرطات سفلية. يظهر صندوق البريد الوارد ‘Team’ أسفل تلك المكونة في الإعداد المتقدم.
يمكنك أيضًا رؤية تحذير خاص بالمسؤول فقط، يظهر لأن مجموعة ‘admin’ تمت إضافتها إلى التكوين المتقدم وإلى الإعداد hide_group_inboxes في نفس الوقت.

[nathank (Nathan Kershaw)]

هذا رائع ببساطة لأولئك الذين يستخدمون المجموعات للتواصل. عمل رائع، @Moin!

شكرًا لك على الاستماع إلى آراء الآخرين (وأنا) والتفاعل معها بنشاط - وإنتاج مكون سمة مصمم جيدًا وعملي يحل مشكلة طويلة الأمد بأناقة.

[agit (Bren Typo)]

مرحباً @Moin، عمل رائع وشكراً جزيلاً.

كنت أسأل عما إذا كان يمكن أن تكون ميزة، خاصة عند العمل مع العديد من المجموعات، جزءًا من هذا المكون الإضافي. العرض المجمع لجميع رسائل المجموعة. في عرض الرسائل الخاصة (PN)، توجد بالفعل طريقة لتصور بشارة صغيرة بأن هذه الرسالة تذهب أيضًا إلى المجموعة، فلماذا لا يتم عرض جميع الرسائل بشارات تشير إلى المجموعة التي تنتمي إليها:

[Moin]

@agit

كنت أسأل عما إذا كانت ميزة، خاصة عندما تعمل مع الكثير من المجموعات، يمكن أن تكون جزءًا من هذا المكون الإضافي.

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

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

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

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