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!
¿Hay alguna forma de cambiar el orden de clasificación de las tarjetas, aunque requiera modificar el código? Me gustaría que fuera alfabético en lugar de por recuento de temas. ¡Gracias!
Hola a todos. La documentación y esta extensión de la documentación son fantásticas. Solo una cosa. ¿Alguien puede ayudarme a agregar estas tarjetas a las secciones top_menu o homepage? Sería genial tener una página de inicio estándar con ‘Latest’ por defecto, pero con estas tarjetas en la parte superior. Luego, hacer clic en una tarjeta te llevaría a la página de documentación filtrada.
Además, tengo otro plugin (Search box) en la sección top_menu. No he podido averiguar cómo cambiar el orden si hay varios plugins que se muestran en esta sección.
Probamos el tc y funciona muy bien para tu caso de uso. Ahora podemos crear una base de conocimientos.
En este contexto, tengo una pregunta: ¿Puedes sugerir alguna solución alternativa para agregar algunos parámetros a cada tarjeta de categoría o etiqueta? De esa manera, nos gustaría agregar &order=title para afectar la clasificación de cada tarjeta de categoría o etiqueta individual.
Podríamos añadir un parámetro de ordenación en la configuración del tema iconos de categoría. Por ejemplo, en el caso de 6,heart, podemos añadir un comando de ordenación adicional, por ejemplo, para ordenar por título de tema ascendente, sería 6,heart,title-asc.
Al abrir la tarjeta de categoría, simplemente añadiría los parámetros de la documentación, como: /docs?ascending=true&category=71&order=title
Si bien es posible que esto funcione bien en un sitio, sin mucha retroalimentación sobre este tema centrada en la capacidad de ordenar las tarjetas, no siento necesariamente que el tiempo dedicado a hacer que esto funcione correctamente esté justificado actualmente.
Dicho esto, alentamos las PR en los componentes, así como a bifurcar un componente para usarlo a su manera.
No dude en hacer una PR con esta funcionalidad, o bifurcarla para desarrollarla usted mismo.
¡Definitivamente damos la bienvenida a PRs beneficiosos a nuestros componentes!
Si fueras a agregar la capacidad de ordenar estas tarjetas, sugeriría crear una nueva lista de valores donde puedas poner el orden de las tarjetas por ID de categoría e ID de etiqueta. No las agregaría a una lista de valores ya existente para algo no relacionado.
@jordan.vidrine Gracias por diseñar el gran componente. ¿Hay alguna forma de deshabilitar el componente en dispositivos móviles pero mostrarlo en PC/Mac?
Suficiente. Pero, ¿podrías al menos cambiar la configuración de iconos de categoría a lista de valores? Es mucho más fácil administrar las tarjetas en varios campos de texto en lugar de uno solo. ;)\n\nY como solución temporal, sería de gran ayuda si cada tarjeta de documentación tuviera una clase CSS con la categoría o etiqueta correspondiente.\n\nAntes: \u003ca class=\"docs-card-box category-card\"\u003e\nDespués: \u003ca class=\"docs-card-box [category-slug] category-card\"\u003e
Después de pensarlo más, he decidido no cambiar la configuración de iconos de categoría a una lista de valores, ya que sin una opción de respaldo, los componentes de los usuarios actuales se romperían.
Agregar un respaldo implicaría verificar si el usuario ha configurado los íconos en el campo actual o en el nuevo campo lista de valores, y creo que es demasiado engorroso agregar esto a este componente, ya que agregaría otro nivel de configuración y podría causar confusión.
En cuanto a las adiciones de clases, es una gran idea, pero no tengo un cronograma para cuándo se agregará, ya que hay cosas más importantes que requieren mi atención.
Dicho esto, cuando sea posible, también damos la bienvenida a PRs a nuestros componentes, ¡después de todo, somos de código abierto!
