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

[Discourse]

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

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

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

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

الميزات

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

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

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

• متوفر فقط عند استخدامه مع إضافة Calendar.
  ** متوفر فقط عند استخدامه مع إضافة Gamification.

يمكنك أيضًا استخدام مكونات Ember أخرى ككتل، ما عليك سوى استخدام الاسم الصحيح. على سبيل المثال، يتضمن الأساس مكون Ember signup-cta، ويمكنك استخدامه في الشريط الجانبي كما هو. لاحظ أنه لا يمكنك استخدام المكونات التي تتوقع مجموعة من المعلمات، ولكن يمكنك بناء مكون 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	قائمة العلامات المستبعدة		tagnames	popular-tags
displayInSpecificCategories	قائمة الفئات لعرض الأداة	الكل	أرقام مفصولة بفواصل	popular-tags
id	معرف لوحة المتصدرين		رقم	minimal-gamification-leaderboard
tag	العلامة المراد عرضها		معرف العلامة	tag-topics
period	الفترة الزمنية لأهم الموضوعات	weekly	all, yearly, quarterly, monthly, weekly, daily	top-topics
title	عنوان الكتلة	يختلف	string	tag-topics, category-list, top-contributors
excludedGroupNames	يستبعد المجموعات المحددة		أسماء المجموعات	top-contributors
order	ترتيب المساهمين		String (likes_received أو likes_given)	top-contributors
period	الفترة الزمنية لأهم المساهمين	yearly	all, yearly, quarterly, monthly, weekly, daily	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).

مستضاف من قبلنا؟ مكونات السمات متاحة للاستخدام في خططنا القياسية، والأعمال، والمؤسسات.

[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 لإضافة رأس/تذييل يدوياً.