Esta guía explica el sistema avanzado de filtrado de temas de Discourse, incluyendo la sintaxis completa del lenguaje de consulta, las opciones de filtro y cómo usar la ruta
/filterde manera efectiva.
Nivel de usuario requerido: Todos los usuarios
Usando el lenguaje de consulta de filtro de temas de Discourse
El filtro de temas de Discourse proporciona un potente lenguaje de consulta para encontrar temas basados en múltiples criterios. Esta interfaz de búsqueda avanzada te permite combinar filtros, ordenar resultados y crear consultas precisas para cualquier contenido en tu foro.
Accediendo al filtro
Puedes acceder al filtro de temas de dos maneras:
Acceso directo por URL:
Navega a /filter en tu instancia de Discourse (por ejemplo: https://meta.discourse.org/filter)
Navegación por la barra lateral:
Haz clic en “Más” en tu barra lateral, luego selecciona la opción de filtro
La interfaz del filtro incluye un sistema inteligente de autocompletado que sugiere filtros y valores disponibles a medida que escribes.
Sintaxis básica de consulta
Los filtros utilizan una sintaxis estructurada con el formato:
nombre-del-filtro:valor
Combinar múltiples filtros:
category:support status:open created-after:2023-01-01
Incluir términos de búsqueda regulares:
category:support ssl certificate error
Esto busca temas en la categoría “support” que contengan las palabras “ssl certificate error”.
Filtros de categoría
category: (alias: categories:)
Filtra temas por categoría
Uso básico:
category:support
category:dev,support # Temas en categorías dev O support
category:documentation:admins # Temas en la subcategoría admins de documentation
Prefijos avanzados:
=- Categoría sin subcategorías:=category:general-- Excluir categoría:-category:off-topic-=- Excluir categoría sin subcategorías:-=category:meta
Ejemplos:
category:bug,feature # Incluir categorías de bug o feature (con subcategorías)
=category:bug,feature # Incluir categorías de bug o feature (sin subcategorías)
-category:bug,feature # Excluir categorías de bug o feature (con subcategorías)
-=category:bug,feature # Excluir categorías de bug o feature (sin subcategorías)
Filtros de etiquetas
tag: (alias: tags:)
Filtra temas por etiquetas (requiere que el etiquetado esté habilitado)
Uso básico:
tag:bug
tag:feature,enhancement # Temas con etiquetas feature O enhancement
tag:bug+urgent # Temas con ambas etiquetas bug Y urgent
Exclusión:
-tag:solved # Excluir temas con la etiqueta solved
-tag:bug+urgent # Excluir temas con ambas etiquetas bug y urgent
-tag:bug,urgent # Excluir temas con etiqueta bug o urgent
tag_group:
Filtra por grupos de etiquetas
Uso básico:
tag_group:moderation
-tag_group:staff-only # Excluir temas con etiquetas del grupo staff-only
Filtros de fecha
Todos los filtros de fecha admiten fechas específicas (YYYY-MM-DD) y días relativos:
Fechas de actividad
activity-before:- Temas con última actividad antes de la fechaactivity-after:- Temas con última actividad después de la fecha
Fechas de creación
created-before:- Temas creados antes de la fechacreated-after:- Temas creados después de la fecha
Fechas de la última publicación
latest-post-before:- Temas con la última publicación antes de la fechalatest-post-after:- Temas con la última publicación después de la fecha
Ejemplos de formato de fecha:
created-after:2023-12-25 # Fecha específica (YYYY-MM-DD)
created-after:30 # Hace 30 días
created-after:1 # Ayer
created-after:0 # Hoy
Sugerencias rápidas:
1- Ayer7- La semana pasada30- El mes pasado365- El año pasado
Filtros de usuario
created-by:
Filtra por autor del tema
Uso básico:
created-by:username
created-by:user1,user2 # Temas de user1 O user2
created-by:@username # El prefijo @ es opcional
Filtros personales (solo usuarios autenticados)
in:
Filtra por tu relación personal con los temas
Opciones disponibles:
in:pinned- Temas fijados para tiin:bookmarked- Temas que has marcadoin:watching- Temas que estás siguiendoin:tracking- Temas que estás rastreandoin:muted- Temas que has silenciadoin:normal- Temas con nivel de notificación normalin:watching_first_post- Temas donde solo sigues la primera publicación
Ejemplos:
in:bookmarked category:support
in:watching,tracking # Temas que estás siguiendo O rastreando
Filtros numéricos
Filtros de “me gusta”
likes-min:- Mínimo de “me gusta” totales en todas las publicacioneslikes-max:- Máximo de “me gusta” totales en todas las publicacioneslikes-op-min:- Mínimo de “me gusta” en la publicación iniciallikes-op-max:- Máximo de “me gusta” en la publicación inicial
Filtros de recuento de publicaciones
posts-min:- Mínimo número de publicacionesposts-max:- Máximo número de publicaciones
Filtros de participantes
posters-min:- Mínimo número de participantesposters-max:- Máximo número de participantes
Filtros de recuento de vistas
views-min:- Mínimo recuento de vistasviews-max:- Máximo recuento de vistas
Ejemplos:
likes-min:10 # Temas con al menos 10 "me gusta"
posts-min:5 posts-max:20 # Temas con 5-20 publicaciones
views-min:100 likes-op-min:5 # Temas populares con publicaciones iniciales interesantes
Filtros de estado
status:
Filtra por el estado del tema
Estados disponibles:
status:open- Temas abiertos (no cerrados ni archivados)status:closed- Temas cerradosstatus:archived- Temas archivadosstatus:listed- Temas listados (visibles)status:unlisted- Temas no listadosstatus:deleted- Temas eliminados (requiere permiso)status:public- Temas públicos (categorías no restringidas)
Estados específicos de plugins:
status:solved- Temas resueltos (con el plugin Solved)status:unsolved- Temas no resueltos (con el plugin Solved)
Ejemplos:
status:open category:support
status:closed created-after:30
Opciones de ordenación
order:
Ordena los resultados por diferentes criterios
Ordenaciones disponibles:
order:activity- Actividad más reciente (por defecto, descendente)order:activity-asc- Actividad más antigua primeroorder:created- Fecha de creación (más recientes primero)order:created-asc- Más antiguos primeroorder:latest-post- Fecha de la última publicación (más reciente primero)order:latest-post-asc- Última publicación más antiguaorder:likes- Más “me gusta” en todas las publicacionesorder:likes-asc- Menos “me gusta”order:likes-op- Más “me gusta” en la publicación inicialorder:likes-op-asc- Menos “me gusta” en la publicación inicialorder:posters- Más participantesorder:posters-asc- Menos participantesorder:title- Alfabéticamente por títuloorder:title-asc- Alfabéticamente inversoorder:views- Más vistasorder:views-asc- Menos vistasorder:category- Nombre de la categoríaorder:category-asc- Nombre de la categoría inversoorder:read- Fecha de última lectura (usuarios autenticados)order:read-asc- Lectura más antigua primero
Ejemplos avanzados
Encuentra discusiones recientes populares:
created-after:7 likes-min:10 order:likes
Temas de soporte que necesitan atención:
category:support status:open posts-max:3 created-after:7
Tus temas de desarrollo marcados:
category:dev in:bookmarked order:activity
Excluye informes de errores resueltos:
category:bug -tag:solved status:open order:created
Temas de alta participación de usuarios específicos:
created-by:admin,moderator likes-min:5 views-min:100
Temas no listados recientes (solo personal):
status:unlisted created-after:30 order:created
Funciones de autocompletado
La entrada del filtro proporciona sugerencias inteligentes:
- Sugerencias de filtros - Muestra los filtros disponibles a medida que escribes
- Autocompletado de categorías - Sugiere categorías por nombre o slug
- Autocompletado de etiquetas - Sugiere etiquetas con recuentos de publicaciones
- Autocompletado de nombres de usuario - Sugiere nombres de usuario con nombres de visualización
- Sugerencias de fechas - Ofrece opciones rápidas de fechas (ayer, la semana pasada, etc.)
- Soporte de prefijos - Muestra opciones de prefijos para categorías y etiquetas
Consejos y mejores prácticas
- Usa el autocompletado - La interfaz del filtro proporciona sugerencias inteligentes a medida que escribes
- Combina filtros - Mezcla diferentes tipos de filtros para obtener resultados precisos
- Comparte URLs de filtros - Las URLs de filtros son compartibles: copia la URL para compartir tu búsqueda
- Añade filtros útiles a tu barra lateral - Las URLs de filtros se pueden añadir a tu barra lateral para un fácil acceso
- Usa la exclusión - Usa el prefijo
-para excluir resultados no deseados - Atajos de fecha - Usa números para fechas relativas (30 = hace 30 días)
- Navegación por teclado - Usa las teclas de flecha para navegar por las sugerencias, Tab/Enter para seleccionar
Creación de enlaces personalizados en la barra lateral
Puedes añadir enlaces de filtro a tu barra lateral como enlaces personalizados:
- Ve a la configuración de tu barra lateral
- Añade un enlace personalizado con una URL de filtro como
/filter?q=category:support status:open - Dale un nombre descriptivo como “Temas de soporte abiertos”
Notas técnicas
- El filtro utiliza la búsqueda de texto completo para palabras clave combinadas con filtros
- Se aplica una longitud mínima de término de búsqueda a las búsquedas de palabras clave
- Los resultados tienen en cuenta los permisos: solo ves los temas a los que puedes acceder
- Las consultas de filtro se procesan en el lado del servidor para mejorar el rendimiento
- La función admite extensiones de plugins para filtros personalizados