فلتر بطاقات Discourse Docs

:discourse2: ملخص يُستخدم فلتر بطاقات مستندات Discourse مع إضافة مستندات Discourse ويسمح لك بوضع “بطاقات” تعمل كفلتر قابل للنقر للحصول على نتائج تصفية أسرع عند دخول المستخدمين إلى صفحة /docs.
:eyeglasses: معاينة معاينة على منشئ سمة Discourse
:hammer_and_wrench: رابط المستودع https://github.com/discourse/discourse-docs-card-filter
:open_book: جديد في سمات Discourse؟ دليل المبتدئين لاستخدام سمات Discourse

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

الميزات

سيتم عرض ما سبق مع هذه الإعدادات في إضافة docs:

الإعدادات

يمكنك اختيار أيقونات مخصصة لكل فلتر فئة أو وسم. يمكنك أيضًا السماح بعرض أوصاف الفئات في فلاتر بطاقات الفئات.

الاسم الوصف
أيقونات الفئات اختر الأيقونات وترتيب المواضيع لمعرفات الفئات المقابلة. على سبيل المثال، ‘6,heart,title-asc’ سيُعين أيقونة القلب للفئة 6 وسيقوم بترتيب قائمة المواضيع حسب النشاط التصاعدي. ملاحظة: يمكن أن يكون الترتيب (العنوان،النشاط)-(تصاعدي/تنازلي)
وصف الفئة تمكين عرض وصف الفئة في فلاتر بطاقات الفئات لصفحة المستندات.
أيقونات الوسوم اختر الأيقونات وترتيب المواضيع لوسوم الفئات المقابلة. على سبيل المثال، ‘featured,heart,activity-desc’ سيُعين أيقونة القلب لوسم مميز وسيقوم بترتيب قائمة المواضيع حسب النشاط التنازلي. ملاحظة: يمكن أن يكون الترتيب (العنوان،النشاط)-(تصاعدي/تنازلي)
الترجمة الافتراضي
topics مواضيع
topic موضوع

:discourse2: مُستضاف لدينا؟ تتوفر مكونات السمات للاستخدام في خططنا القياسية، والأعمال، والمؤسسية.

33 إعجابًا

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

إعجاب واحد (1)

ينبغي أن يكون هذا هو الحال نظرًا لأننا نحصل على معلومات الفئة من

@discourseComputed("category")
  categoryInfo(category) {
    return this.site.categories.findBy("id", category.id);
  },

بحسب علمي، فإن this.site.categories ستُرجع فقط الفئات التي يمكن للمستخدم الحالي عرضها.

إعجابَين (2)

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

3 إعجابات

هل من الممكن أن العداد في /docs لا يحسب المواضيع التي تم نقلها إلى هذه الفئة بعد إنشائها؟

لقد أنشأت للتو فئة جديدة، وأضفتها في docs، ونقلت بعض المواضيع، لكن العداد لا يزال يُظهر “0 موضوع”.

تعديل: يبدو أنه يحتاج فقط إلى بعض الوقت للتحديث.

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

إعجاب واحد (1)

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

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

شكرا.

3 إعجابات

مرحباً @jordan.vidrine

لقد جربنا tc وهو يعمل بشكل رائع لحالتك. الآن يمكننا إنشاء قاعدة معرفية (KB)

في هذا السياق، لدي سؤال: هل يمكنك اقتراح أي حل بديل لإضافة بعض المعلمات إلى كل بطاقة فئة أو بطاقة علامة؟ بهذه الطريقة، نرغب في إلحاق &order=title للتأثير على الفرز لكل بطاقة فئة أو بطاقة علامة فردية.

ملاحظة:

هممم.. لست متأكدًا.

كيف ترغب في ظهور ترتيب بطاقات الفئات والعلامات؟

مرحباً جوردان

يمكننا إضافة معلمة فرز في إعداد سمة أيقونات الفئات. على سبيل المثال، في حالة 6,heart، يمكننا إضافة أمر فرز إضافي، على سبيل المثال للفرز حسب عنوان الموضوع تصاعديًا، سيكون 6,heart,title-asc.

عند فتح بطاقة الفئة، سيتم عندها فقط إلحاق معلمات المستندات مثل: /docs?ascending=true&category=71&order=title

ما رأيك في ذلك؟

إعجاب واحد (1)

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

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

لا تتردد في تقديم طلب سحب (PR) بهذه الوظيفة، أو استنساخها لتطويرها بنفسك.

3 إعجابات

يمكنني تقديم طلب سحب لهذا الطلب حيث أن @jrgong ترعى العمل.

4 إعجابات

رفع هذا الموضوع! هل تمكن أي شخص من معرفة ذلك؟

إعجابَين (2)

كان حلي هو إيقاف تشغيل البطاقات (نظرًا لأن لدي العديد من الفئات لجعلها مفيدة على أي حال) وتعديل ترتيب فرز المستندات. يمكنك رؤية المزيد حول ذلك هنا Modifying Discourse Docs to only allow for sorting by Title - #2 by Nick_Chomey

إعجابَين (2)

نرحب بالتأكيد بطلبات السحب (PRs) المفيدة لمكوناتنا!

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

:smile:

إعجاب واحد (1)

@jordan.vidrine شكراً لك على تصميم المكون الرائع. هل هناك أي طريقة لتعطيل المكون على الأجهزة المحمولة ولكن عرضه على أجهزة الكمبيوتر الشخصية/أجهزة Mac؟

حسناً. ولكن هل يمكنك على الأقل تغيير إعداد أيقونات الفئة إلى قائمة قيم؟ من الأسهل بكثير إدارة البطاقات في حقول نصية متعددة بدلاً من حقل واحد. :wink:

وكحل مؤقت، سيكون من المفيد للغاية إذا كان لكل بطاقة مستندات فئة CSS مع الشريحة الفئوية أو الوسم المعني.

قبل: <a>
بعد: <a class="docs-card-box [category-slug] category-card">

إعجاب واحد (1)

هذا اقتراح جيد :+1:

إعجابَين (2)

أخبرني إذا كنت بحاجة إلى مساعدة في الاختبار، سأكون سعيدًا بأن أكون فأر التجارب :slight_smile:

إعجاب واحد (1)

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

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

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

ومع ذلك، عندما يكون ذلك ممكنًا، نرحب أيضًا بطلبات السحب (PRs) لمكوناتنا، فنحن مفتوحو المصدر في النهاية!

إعجاب واحد (1)