Discourse Docs Card Filter is to be used with the Discourse Docs Plugin and allows you to place “Cards” that act as a clickable filter for quicker filter results upon entering the /docs page by your users.
You can select custom icons for each category or tag card filter. You can also allow category descriptions to be rendered in the category card filters.
Name
Description
category icons
Choose icons & topics order for corresponding category IDs. ex. ‘6,heart,title-asc’ would assign the heart icon to category 6 & will order topic list by ascending activity. NOTE: order can be (title,activity)-(asc/desc)
category description
Enable the category description to be displayed in the category card filters for the docs page.
tag icons
Choose icons & topics order for corresponding tag slugs. ex. ‘featured,heart,activity-desc’ would assign the heart icon to featured tag & will order topic list by ascending activity. NOTE: order can be (title,activity)-(asc/desc)
Translation
Default
topics
Topics
topic
Topic
Hosted by us? Theme components are available to use on our Standard, Business, and Enterprise plans.
Thanks for building this! Is it the case that if a user doesn’t have view permissions on a (private) category, the card for that private category won’t appear above the search box? (Or I suppose on the sidebar, but just want to confirm the behavior is consistent.)
Excellent. That will make it a real easy-to-use tool for people in our multiple workgroups who want quick access to their group(s) reference materials, and quickly filter our Group A from Group B, etc. Thanks!
مرحباً بالجميع. الوثائق وهذا الامتداد للوثائق رائعة. شيء واحد فقط. هل يمكن لأي شخص مساعدتي في إضافة هذه البطاقات إلى أقسام top_menu أو homepage؟ سيكون من الرائع أن يكون لديك صفحة رئيسية قياسية مع “الأحدث” افتراضيًا، مع وجود هذه البطاقات في الأعلى. ثم النقر على بطاقة سيأخذك إلى صفحة الوثائق المفلترة.
أيضًا، لدي إضافة أخرى (مربع البحث) موجودة في قسم top_menu. لم أتمكن من معرفة كيفية تغيير الترتيب إذا كانت هناك إضافات متعددة تظهر في هذا القسم.
لقد جربنا tc وهو يعمل بشكل رائع لحالتك. الآن يمكننا إنشاء قاعدة معرفية (KB)
في هذا السياق، لدي سؤال: هل يمكنك اقتراح أي حل بديل لإضافة بعض المعلمات إلى كل بطاقة فئة أو بطاقة علامة؟ بهذه الطريقة، نرغب في إلحاق &order=title للتأثير على الفرز لكل بطاقة فئة أو بطاقة علامة فردية.
يمكننا إضافة معلمة فرز في إعداد سمة أيقونات الفئات. على سبيل المثال، في حالة 6,heart، يمكننا إضافة أمر فرز إضافي، على سبيل المثال للفرز حسب عنوان الموضوع تصاعديًا، سيكون 6,heart,title-asc.
عند فتح بطاقة الفئة، سيتم عندها فقط إلحاق معلمات المستندات مثل: /docs?ascending=true&category=71&order=title
في حين أنه من الممكن أن يعمل هذا بشكل جيد على موقع ما، ودون الكثير من التعليقات حول هذا الموضوع الذي يركز على القدرة على فرز البطاقات، لا أشعر بالضرورة أن الوقت المستغرق لجعل هذا يعمل بشكل صحيح مبرر حاليًا.
ومع ذلك، فإننا نشجع على تقديم طلبات السحب (PRs) على المكونات، وكذلك على استنساخ مكون لاستخدامه بطريقتك الخاصة!
لا تتردد في تقديم طلب سحب (PR) بهذه الوظيفة، أو استنساخها لتطويرها بنفسك.
إذا كنت ستضيف القدرة على فرز هذه البطاقات، أقترح إنشاء قائمة قيم جديدة حيث يمكنك وضع ترتيب البطاقات حسب معرف الفئة ومعرف العلامة. لن أضيفها إلى قائمة قيم موجودة بالفعل لشيء غير ذي صلة.
بعد التفكير مليًا، قررت عدم تغيير إعداد أيقونات الفئة إلى قائمة قيم، لأنه بدون خيار احتياطي، سيتسبب ذلك في تعطل مكونات المستخدمين الحاليين.
ستبدو إضافة خيار احتياطي كالتالي: التحقق مما إذا كان المستخدم قد قام بتعيين الأيقونات في الحقل الحالي، أو الحقل الجديد قائمة القيم، وأعتقد أن هذا معقد للغاية لإضافته إلى هذا المكون، لأنه سيضيف مستوى آخر من الإعدادات ويسبب ارتباكًا محتملاً.
بالنسبة لإضافات الفئة، إنها فكرة رائعة، لكن ليس لدي جدول زمني لموعد إضافة ذلك حيث توجد أشياء أكثر أهمية تحتاج إلى اهتمامي.
ومع ذلك، عندما يكون ذلك ممكنًا، نرحب أيضًا بطلبات السحب (PRs) لمكوناتنا، فنحن مفتوحو المصدر في النهاية!
