Discourse Docs Card Filter debe usarse con el plugin Discourse Docs y permite colocar “Tarjetas” que funcionan como un filtro clickeable para obtener resultados de filtrado más rápidos al acceder a la página /docs por parte de sus usuarios.
Puedes seleccionar iconos personalizados para cada categoría o tarjeta de filtro por etiqueta. También puedes permitir que las descripciones de las categorías se rendericen en los filtros de tarjetas de categoría.
Nombre
Descripción
category icons
Elige iconos y orden de los temas para los IDs de categoría correspondientes. Ej. ‘6,heart,title-asc’ asignaría el icono de corazón a la categoría 6 y ordenaría la lista de temas por actividad ascendente. NOTA: el orden puede ser (title,activity)-(asc/desc)
category description
Habilitar la visualización de la descripción de la categoría en los filtros de tarjetas de categoría para la página de docs.
tag icons
Elige iconos y orden de los temas para los slugs de etiqueta correspondientes. Ej. ‘featured,heart,activity-desc’ asignaría el icono de corazón a la etiqueta featured y ordenaría la lista de temas por actividad ascendente. NOTA: el orden puede ser (title,activity)-(asc/desc)
Traducción
Predeterminado
topics
Temas
topic
Tema
¿Alojado por nosotros? Los componentes de tema están disponibles para su uso en nuestros planes Standard, Business y Enterprise.
¡Gracias por crear esto! ¿Es cierto que si un usuario no tiene permisos de visualización en una categoría (privada), la tarjeta de esa categoría privada no aparecerá encima del cuadro de búsqueda? (O supongo que tampoco en la barra lateral, pero solo quiero confirmar que el comportamiento sea consistente.)
Excelente. Eso hará que sea una herramienta muy fácil de usar para las personas de nuestros múltiples grupos de trabajo que deseen acceso rápido a los materiales de referencia de su(s) grupo(s) y puedan filtrar rápidamente el Grupo A del Grupo B, etc. ¡Gracias!
¿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!
¿Alojado por nosotros? Los componentes de tema están disponibles para su uso en nuestros planes Standard, Business y Enterprise.
