كتل الشريط الجانبي الأيمن

[Discourse]

	ملخص	يعرض Right Sidebar Blocks شريطًا جانبيًا على يمين قوائم المواضيع مع قائمة قابلة للتكوين من الكتل.
	معاينة	معاينة على منشئ مواضيع Discourse
	رابط المستودع	https://github.com/discourse/discourse-right-sidebar-blocks
	جديد في مواضيع Discourse؟	دليل المبتدئين لاستخدام مواضيع Discourse

تثبيت مكون هذا الموضوع

نظرًا لأن هذا مكون موضوع #رسمي يُصان بواسطة فريق Discourse، يمكن تقديم طلبات #الدعم، و#الإبلاغ عن الأخطاء:bug، و#المساهمة في تجربة المستخدم:ux، و#المساهمة في الميزات:feature في الفئات المقابلة هنا على Meta، مع وضع العلامة المناسبة لمكون الموضوع. انقر على الرابط أدناه لبدء واحد.

 الدعم  خطأ  تجربة المستخدم  ميزة

الميزات

يتضمن المكون عددًا من الكتل التي يمكنك عرضها في الشريط الجانبي:

• popular-tags
• top-contributors
• recent-replies
• category-topics
• custom-html
• category-list
• subcategory-list
• upcoming-events-list*
• minimal-gamification-leaderboard**

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

* متوفر فقط عند استخدامه مع إضافة التقويم.
** متوفر فقط عند استخدامه مع إضافة التلعيب.

يمكنك أيضًا استخدام مكونات Ember أخرى ككتل، كل ما عليك هو استخدام الاسم الصحيح. على سبيل المثال، يتضمن النواة مكون signup-cta من Ember، ويمكنك استخدامه في الشريط الجانبي كما هو. لاحظ أنه لا يمكنك استخدام المكونات التي تتوقع مجموعة من المعلمات، ولكن يمكنك بناء مكون Ember خاص بك في موضوع منفصل والرجوع إليه فقط باسمه في إعداد blocks للشريط الجانبي.

يمكنك التحكم في بعض الميزات للكتل المقدمة عبر المعلمات.

الاسم	الوصف	الافتراضي	القيمة	متاح لـ
count	يحد من عدد النتائج	يختلف	رقم	الكل ما عدا custom-html
excerptLimit	يحد من طول مقتطف كل رد	150	رقم	recent-replies
id	معرف الفئة		معرف الفئة (تستخدم category-list مفصولة بفواصل)	category-topics, category-list
content	المحتويات المراد عرضها		html	custom-html
scopeToCategory	يظهر فقط في الفئة أو الفئة الفرعية X		معرف الفئة	popular-tags
excludedTags	قائمة الوسوم المستبعدة		أسماء الوسوم	popular-tags
displayInSpecificCategories	قائمة الفئات لعرض الأداة	الكل	أرقام مفصولة بفواصل	popular-tags
id	معرف لوحة المتصدرين		رقم	minimal-gamification-leaderboard
tag	الوسم المراد عرضه		اسم الوسم	tag-topics
period	الفترة الزمنية للمواضيع الرئيسية	أسبوعي	الكل، سنوي، ربع سنوي، شهري، أسبوعي، يومي	top-topics
title	عنوان الكتلة	يختلف	نص	tag-topics, category-list, top-contributors
excludedGroupNames	يستبعد المجموعات المحددة		أسماء المجموعات	top-contributors
order	يرتب المساهمين		نص (likes_received أو likes_given)	top-contributors
period	الفترة الزمنية للمساهمين الرئيسيين	سنوي	الكل، سنوي، ربع سنوي، شهري، أسبوعي، يومي	top-contributors
upcomingDays	الأحداث التي بدأت قبل القيمة المقدمة	180	رقم	upcoming-events-list
timeFormat	تنسيق تاريخ/وقت الحدث	LT	تنسيق momentjs	upcoming-events-list

الإعدادات

الاسم	الوصف
blocks
show in routes	للمستخدمين المتقدمين فقط: حد الشريط الجانبي للمسارات المحددة. أمثلة: discovery.latest, discovery.unread, discovery.new, discovery.top, tag.show, “c/category-slug” (للفئات), “tag/sample-tag” (للوسوم). عندما يكون فارغًا، يُعرض الشريط الجانبي على جميع مسارات القوائم.

blocks: اختر الكتل المراد عرضها وعدّل ترتيبها

show_in_routes: حدد المسارات التي ستعرض فيها الشريط الجانبي لقوائم المواضيع. افتراضيًا، سيظهر على جميع مسارات الاكتشاف ما عدا /categories.

الترجمة	الافتراضي
top_contributors.heading	المساهمون الرئيسيون
top_contributors.view_all	عرض الكل
popular_tags.heading	الوسوم الشائعة
popular_tags.view_all	عرض الكل
recent_replies.heading	الردود الأخيرة
subcategory_list.heading	الفئات الفرعية
top_topics.heading	المواضيع الرئيسية
category_list.heading	الفئات

لقطات الشاشة

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

التفاعلات

عند استخدامه بالتزامن مع إضافة Discourse Calendar، يمكنك إضافة كتلة شريط جانبي للأحداث القادمة. اسم الكتلة هو upcoming-events-list، ويمكن تخصيص تنسيق التاريخ وفقًا لهذا التركيب (على سبيل المثال، MMMM D, YYYY).

مُستضاف لدينا؟ تتوفر مكونات الموضوع للاستخدام في خطط Pro وBusiness وEnterprise لدينا.

[Alaa]

ماذا يجب أن أضيف في المعلمة “name” إذا استخدمت html-custom؟

[nathank (Nathan Kershaw)]

يسعدني رؤية هذا كـ #مكون_سمة_رسمي! إنه يفتح بالتأكيد عالمًا جديدًا من التخصيصات.

لدي سؤالان:

1. في الشريط الجانبي، أريد عرض قائمة المواضيع /latest بنفس الطريقة التي تعرض بها category-topics هذه القائمة. هل هذا ممكن؟ recent-replies يقترب من ذلك (خاصة إذا تم إخفاء المقتطف)، لكنني أريد حقًا تضمين المواضيع التي ليس لها ردود.

2. هل من الممكن عرض الكتل الجانبية في فئات معينة فقط؟ ما أعنيه هو أن المسار الوحيد المعروض هو قائمة مواضيع الفئة، وفقط للفئات التي أحددها.

[pmusaraj (Penar Musaraj)]

نعتذر، الوثائق الخاصة بهذا الأمر تفتقر إلى التفاصيل (سأقوم بتحديثها الآن). اسم المعلمة لـ custom-html هو content.

@nathankershaw

أريد عرض قائمة المواضيع /latest

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

@nathankershaw

هل من الممكن عرض الكتل الجانبية في فئات معينة فقط؟

حاليًا، لا، لا يمكنك عرضها في فئات محددة فقط. ومع ذلك، يمكنك استخدام discovery.category في إعداد show in routes، وهذا سيعرض الشريط الجانبي فقط في مسارات الفئات (ولكن في جميعها، وليس مجموعة فرعية).

[Alaa]

شكراً لك، هل من الممكن تضمين الشريط الجانبي في كل موضوع أيضاً؟

[albert_vu (Albert Vũ)]

لقد لاحظت للتو قيدًا على المكون، خاصةً عندما يتعلق الأمر بكتل category-topics و subcategory-list، وهو أن إضافة كتل متعددة من أي من هذين النوعين بمعرفات مختلفة يؤدي دائمًا إلى ظهور مواضيع/قوائم فرعية من الكتلة العلوية في محرر التشغيل (أفترض).

إحدى المشكلات التي أواجهها الآن هي أنه بعد تجربة كتلة subcategory-list حوالي 10-12 مرة، توقفت عن الظهور تمامًا على موقع الاختبار الخاص بنا (انظر الفيديو أدناه).

[pmusaraj (Penar Musaraj)]

لا يأخذ المقطع subcategory-list أي معلمة على الإطلاق. عند استخدامه، سيعرض الفئات الفرعية للفئة الحالية بناءً على الفئة الحالية التي انتقلت إليها… لذلك لا معنى لاستخدام هذا المقطع أكثر من مرة.

لهذا السبب أيضًا لا يظهر subcategory-list في الفيديو الخاص بك. إذا كنت على مسار غير فئوي، فلن يظهر هذا المقطع.

بالنسبة لـ category-topics، أرى في الفيديو الخاص بك نفس المعرف مستخدمًا مرتين: 7. لقد أجريت اختبارًا محليًا ومع معرفات مختلفة أحصل على مواضيع مختلفة معروضة (أي لا يمكنني إعادة إنتاج الخطأ المبلغ عنه).

[Helga_Razinkova (Helga)]

مرحباً، شكراً جزيلاً على هذه الإضافة الرائعة!

لدي سؤال حول الشريط الجانبي subcategory-list: هل هناك خيار لعرضه لفئة معينة فقط؟

لقد ألقى المطورون لدينا نظرة، ويبدو أنه لا يوجد دعم لمعرف المعلمة لـ subcategory-list، هل يمكنك إضافة هذا، من فضلك؟

[Helga_Razinkova (Helga)]

وفيما يتعلق بكتلة top-contributors: هل هناك طريقة لجلب النتائج لفترة أسبوع؟

[pmusaraj (Penar Musaraj)]

@Helga_Razinkova

بخصوص قائمة الفئات الفرعية الجانبية: هل هناك خيار لعرضها لفئة معينة فقط؟

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

@Helga_Razinkova

هل هناك طريقة لجلب النتائج لفترة أسبوع؟

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

[miss]

@pmusaraj هل يمكنك إضافة

padding: 3px 4px 3px 4px

لـ popular-tags؟

شكراً.

[Helga_Razinkova (Helga)]

مرحباً @pmusaraj، شكراً جزيلاً على ردك!

لقد شارك المطور لدينا طلبات السحب (PRs) هنا، يرجى إلقاء نظرة: Implement the `displayInCategories` parameter which allows to specify a list of categories where the `subcategories-list` block is displayed by d521bb85 · Pull Request #10 · discourse/discourse-right-sidebar-blocks · GitHub

@pmusaraj

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

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

[pmusaraj (Penar Musaraj)]

@miss

هل يمكنك إضافة

padding: 3px 4px 3px 4px

لـ popular-tags؟

المكون لديه القليل جدًا من الأنماط عن قصد حتى يتمكن المستهلكون من إضافة أنماطهم الخاصة في السمات/مكونات السمات الخاصة بهم.

@Helga_Razinkova

شارك المطور لدينا طلبات السحب هنا، يرجى إلقاء نظرة: Implement the displayInCategories parameter which allows to specify a list of categories where the subcategories-list block is displayed by d521bb85 · Pull Request #10 · discourse/discourse-right-sidebar-blocks · GitHub

شكرًا، طلب السحب هذا رائع وقد تم دمجه الآن!

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

[nathank (Nathan Kershaw)]

@pmusaraj

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

لست متأكدًا من مكان العثور على الكود الخاص بذلك - هل تمانع في توجيهي؟ أود إلقاء نظرة على تعديل category-topics بحيث يمنحك عدم وجود معرف جميع الفئات (وبالتالي قائمة /latest بشكل فعال)

@pmusaraj

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

سيكون من الرائع وجود ذلك في جميع الكتل!

[Helga_Razinkova (Helga)]

@pmusaraj رائع! شكراً جزيلاً على مساعدتك، أتطلع لاستخدام كتلة أفضل المساهمين

[Kuro22]

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

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

d6ca234baf8d2d5e65f414f31e198fe956d9a939.js?__ws=www.bfsu.cafe:98 Uncaught (in promise) TypeError: Cannot read properties of undefined (reading 'findFiltered')
    at new CategoryTopics (d6ca234baf8d2d5e65f414f31e198fe956d9a939.js?__ws=www.bfsu.cafe:98:18)
    at h.createComponent (base-component-manager.js:37:1)
    at h.createComponent (ember-component-manager.js:54:1)
    at C.create (manager.js:558:1)
    at Object.evaluate (runtime.js:3301:1)
    at Object.evaluate (runtime.js:1312:1)
    at Dt.evaluateSyscall (runtime.js:5232:1)
    at Dt.evaluateInner (runtime.js:5188:1)
    at Dt.evaluateOuter (runtime.js:5180:1)
    at Wt.next (runtime.js:6191:1)
    at Wt._execute (runtime.js:6175:1)
    at Wt.execute (runtime.js:6166:1)
    at qt.handleException (runtime.js:5369:1)
    at Kt.handleException (runtime.js:5605:1)
    at Lt.throw (runtime.js:5302:1)
    at Be.evaluate (runtime.js:2580:1)
    at Lt._execute (runtime.js:5285:1)
    at Lt.execute (runtime.js:5266:1)
    at Ht.rerender (runtime.js:5634:1)
    at Er.render (index.js:7578:1)
    at index.js:7896:1)
    at It (runtime.js:5074:1)
    at Rr._renderRoots (index.js:7876:1)
    at Rr._renderRootsTransaction (index.js:7928:1)
    at Rr._revalidate (index.js:7970:1)
    at invoke (backburner.js:351:1)
    at p.flush (backburner.js:241:1)
    at h.flush (backburner.js:447:1)
    at q._end (backburner.js:999:1)
    at _boundAutorunEnd (backburner.js:648:1)
CategoryTopics @ d6ca234baf8d2d5e65f414f31e198fe956d9a939.js?__ws=www.bfsu.cafe:98
createComponent @ base-component-manager.js:37
createComponent @ ember-component-manager.js:54
create @ manager.js:558
（匿名） @ runtime.js:3301
evaluate @ runtime.js:1312
evaluateSyscall @ runtime.js:5232
evaluateInner @ runtime.js:5188
evaluateOuter @ runtime.js:5180
next @ runtime.js:6191
_execute @ runtime.js:6175
execute @ runtime.js:6166
handleException @ runtime.js:5369
handleException @ runtime.js:5605
throw @ runtime.js:5302
evaluate @ runtime.js:2580
_execute @ runtime.js:5285
execute @ runtime.js:5266
rerender @ runtime.js:5634
render @ index.js:7578
（匿名） @ index.js:7896
It @ runtime.js:5074
_renderRoots @ index.js:7876
_renderRootsTransaction @ index.js:7928
_revalidate @ index.js:7970
invoke @ backburner.js:351
flush @ backburner.js:241
flush @ backburner.js:447
_end @ backburner.js:999
_boundAutorunEnd @ backburner.js:648
Promise.then（异步）
n @ backburner.js:28
flush @ index.js:46
_scheduleAutorun @ backburner.js:1218
_end @ backburner.js:1009
_boundAutorunEnd @ backburner.js:648
Promise.then（异步）
n @ backburner.js:28
flush @ index.js:46
_scheduleAutorun @ backburner.js:1218
_end @ backburner.js:1009
_boundAutorunEnd @ backburner.js:648
Promise.then（异步）
n @ backburner.js:28
flush @ index.js:46
_scheduleAutorun @ backburner.js:1218
_end @ backburner.js:1009
_boundAutorunEnd @ backburner.js:648
Promise.then（异步）
n @ backburner.js:28
flush @ index.js:46
_scheduleAutorun @ backburner.js:1218
_ensureInstance @ backburner.js:1206
scheduleOnce @ backburner.js:845
k @ index.js:522
queueRerender @ mount-widget.js:124
scheduleRerender @ widget.js:319
rerenderResult @ widget.js:365
F @ hooks.js:207
（匿名） @ hooks.js:247
dispatch @ jquery.js:5430
_.handle @ jquery.js:5234
frame:251 لقد قمت بتجاهل العلامة، ولكن ملفات تعريف الارتباط الخاصة بالجهات الخارجية معطلة في متصفحك، لذا ستعود العلامة في المرة التالية التي تزور فيها الصفحة.

أرى معلومات حول هذه المكونة في ملف js المذكور في السطر الأول من سجل الخطأ أعلاه.

// line 96-103 of d6ca234baf8d2d5e65f414f31e198fe956d9a939.js?__ws=www.bfsu.cafe
      const filter = "c/" + categoryId;
      this.category = _category.default.findById(categoryId);
      this.store.findFiltered("topicList", {
        filter
      }).then(result => {
        const results = result.topic_list.topics;
        results.forEach(topic => {
          topic.url = "".concat((0, _getUrl.default)("/t/")).concat(topic.slug, "/").concat(topic.id);

[pmusaraj (Penar Musaraj)]

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

[Kuro22]

شكرا! يعمل بشكل رائع الآن.

[Helga_Razinkova (Helga)]

@pmusaraj

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

مرحباً @pmusaraj، آسف إذا كنت أبدو لحوحًا - أردت فقط معرفة ما إذا كان هناك أي وقت تقديري بخصوص هذا التنفيذ.

ستكون إضافة رائعة

شكراً جزيلاً لك!

[carson]

شكراً لك على هذه المكونات الرائعة!

لاحظت أن رأسي وتذييلي بالكامل يختفيان على مستوى العالم عندما أقوم بتمكين هذا (كل شيء في ملفي header.html و footer.html). هل كان هذا مقصوداً؟ ولكن لتجاوز هذا، يتعين علي استخدام PluginAPI لإضافة رأس/تذييل يدوياً.