Ce guide explique le système avancé de filtrage de sujets de Discourse, y compris la syntaxe complète du langage de requête, les options de filtre et comment utiliser efficacement la route
/filter.
Niveau d’utilisateur requis : Tous les utilisateurs
Utilisation du langage de requête de filtre de sujets Discourse
Le filtre de sujets de Discourse fournit un langage de requête puissant pour trouver des sujets basés sur plusieurs critères. Cette interface de recherche avancée vous permet de combiner des filtres, de trier les résultats et de créer des requêtes précises pour tout contenu sur votre forum.
Accès au filtre
Vous pouvez accéder au filtre de sujets de deux manières :
Accès direct par URL :
Naviguez vers /filter sur votre instance Discourse (par exemple : https://meta.discourse.org/filter)
Navigation dans la barre latérale :
Cliquez sur « Plus » dans votre barre latérale, puis sélectionnez l’option de filtre
L’interface de filtre comprend un système de saisie semi-automatique intelligent qui suggère les filtres et les valeurs disponibles au fur et à mesure que vous tapez.
Syntaxe de requête de base
Les filtres utilisent une syntaxe structurée avec le format :
nom-du-filtre:valeur
Combinaison de plusieurs filtres :
catégorie:support statut:ouvert créé-après:2023-01-01
Inclusion de termes de recherche réguliers :
catégorie:support erreur certificat ssl
Ceci recherche des sujets dans la catégorie « support » contenant les mots « erreur certificat ssl ».
Filtres de catégorie
catégorie: (alias : catégories:)
Filtrer les sujets par catégorie
Utilisation de base :
catégorie:support
catégorie:dev,support # Sujets dans les catégories dev OU support
catégorie:documentation:admins # Sujets dans la sous-catégorie admins de documentation
Préfixes avancés :
=- Catégorie sans sous-catégories :=catégorie:général-- Exclure la catégorie :-catégorie:hors-sujet-=- Exclure la catégorie sans sous-catégories :-=catégorie:méta
Exemples :
catégorie:bug,fonctionnalité # Inclure les catégories bug ou fonctionnalité (avec sous-catégories)
=catégorie:bug,fonctionnalité # Inclure les catégories bug ou fonctionnalité (sans sous-catégories)
-catégorie:bug,fonctionnalité # Exclure les catégories bug ou fonctionnalité (avec sous-catégories)
-=catégorie:bug,fonctionnalité # Exclure les catégories bug ou fonctionnalité (sans sous-catégories)
Filtres d’étiquettes
étiquette: (alias : étiquettes:)
Filtrer les sujets par étiquettes (nécessite que la mise en étiquette soit activée)
Utilisation de base :
étiquette:bug
étiquette:fonctionnalité,amélioration # Sujets avec les étiquettes fonctionnalité OU amélioration
étiquette:bug+urgent # Sujets avec les deux étiquettes bug ET urgent
Exclusion :
-étiquette:résolu # Exclure les sujets avec l'étiquette résolu
-étiquette:bug+urgent # Exclure les sujets avec les deux étiquettes bug et urgent
-étiquette:bug,urgent # Exclure les sujets avec les étiquettes bug ou urgent
groupe_étiquette:
Filtrer par groupes d’étiquettes
Utilisation de base :
GROUPE_ÉTiquette:modération
-GROUPE_ÉTiquette:staff-only # Exclure les sujets avec des étiquettes du groupe staff-only
Filtres de date
Tous les filtres de date prennent en charge les dates spécifiques (AAAA-MM-JJ) et les jours relatifs :
Dates d’activité
activité-avant:- Sujets dont la dernière activité est antérieure à la dateactivité-après:- Sujets dont la dernière activité est postérieure à la date
Dates de création
créé-avant:- Sujets créés avant la datecréé-après:- Sujets créés après la date
Dates du dernier message
dernier-message-avant:- Sujets dont le dernier message est antérieur à la datedernier-message-après:- Sujets dont le dernier message est postérieur à la date
Exemples de format de date :
créé-après:2023-12-25 # Date spécifique (AAAA-MM-JJ)
créé-après:30 # Il y a 30 jours
créé-après:1 # Hier
créé-après:0 # Aujourd'hui
Suggestions rapides :
1- Hier7- La semaine dernière30- Le mois dernier365- L’année dernière
Filtres d’utilisateur
créé-par:
Filtrer par auteur du sujet
Utilisation de base :
créé-par:nomdutilisateur
créé-par:utilisateur1,utilisateur2 # Sujets par utilisateur1 OU utilisateur2
créé-par:@nomdutilisateur # Le préfixe @ est facultatif
Filtres personnels (utilisateurs authentifiés uniquement)
dans:
Filtrer par votre relation personnelle avec les sujets
Options disponibles :
dans:épinglé- Sujets épinglés pour vousdans:marqué- Sujets que vous avez mis en marque-pagedans:suivi- Sujets que vous suivezdans:suivi_notifications- Sujets que vous suivez (notifications)dans:ignoré- Sujets que vous avez ignorésdans:normal- Sujets avec un niveau de notification normaldans:suivi_premier_message- Sujets où vous ne suivez que le premier message
Exemples :
dans:marqué catégorie:support
dans:suivi,suivi_notifications # Sujets que vous suivez OU suivez (notifications)
Filtres numériques
Filtres de likes
likes-min:- Nombre minimum de likes total sur tous les messageslikes-max:- Nombre maximum de likes total sur tous les messageslikes-op-min:- Nombre minimum de likes sur le message d’ouverturelikes-op-max:- Nombre maximum de likes sur le message d’ouverture
Filtres de nombre de messages
messages-min:- Nombre minimum de messagesmessages-max:- Nombre maximum de messages
Filtres de participants
participants-min:- Nombre minimum de participantsparticipants-max:- Nombre maximum de participants
Filtres de nombre de vues
vues-min:- Nombre minimum de vuesvues-max:- Nombre maximum de vues
Exemples :
likes-min:10 # Sujets avec au moins 10 likes
messages-min:5 messages-max:20 # Sujets avec 5 à 20 messages
vues-min:100 likes-op-min:5 # Sujets populaires avec des messages d'ouverture engageants
Filtres de statut
statut:
Filtrer par statut du sujet
Statuts disponibles :
statut:ouvert- Sujets ouverts (non fermés ou archivés)statut:fermé- Sujets fermésstatut:archivé- Sujets archivésstatut:listé- Sujets listés (visibles)statut:non-listé- Sujets non listésstatut:supprimé- Sujets supprimés (nécessite une permission)statut:public- Sujets publics (catégories non restreintes)
Statuts spécifiques aux plugins :
statut:résolu- Sujets résolus (avec le plugin Solved)statut:non-résolu- Sujets non résolus (avec le plugin Solved)
Exemples :
statut:ouvert catégorie:support
statut:fermé créé-après:30
Options de tri
ordre:
Trier les résultats par différents critères
Tri disponible :
ordre:activité- Dernière activité (par défaut, décroissant)ordre:activité-asc- Première activité la plus ancienneordre:créé- Date de création (les plus récents d’abord)ordre:créé-asc- Les plus anciens d’abordordre:dernier-message- Date du dernier messageordre:dernier-message-asc- Dernier message le plus ancienordre:likes- Nombre maximum de likes sur tous les messagesordre:likes-asc- Nombre minimum de likesordre:likes-op- Nombre maximum de likes sur le message d’ouvertureordre:likes-op-asc- Nombre minimum de likes sur le message d’ouvertureordre:participants- Nombre maximum de participantsordre:participants-asc- Nombre minimum de participantsordre:titre- Par ordre alphabétique du titreordre:titre-asc- Ordre alphabétique inverseordre:vues- Nombre maximum de vuesordre:vues-asc- Nombre minimum de vuesordre:catégorie- Nom de la catégorieordre:catégorie-asc- Nom de catégorie inverseordre:lu- Date de dernière lecture (utilisateurs authentifiés)ordre:lu-asc- Première lecture la plus ancienne
Exemples avancés
Trouver des discussions récentes populaires :
créé-après:7 likes-min:10 ordre:likes
Sujets de support nécessitant une attention :
catégorie:support statut:ouvert messages-max:3 créé-après:7
Vos sujets de développement mis en marque-page :
catégorie:dev dans:marqué ordre:activité
Exclure les rapports de bugs résolus :
catégorie:bug -étiquette:résolu statut:ouvert ordre:créé
Sujets à fort engagement d’utilisateurs spécifiques :
créé-par:admin,modérateur likes-min:5 vues-min:100
Sujets non listés récents (personnel uniquement) :
statut:non-listé créé-après:30 ordre:créé
Fonctionnalités de saisie semi-automatique
L’entrée du filtre fournit des suggestions intelligentes :
- Suggestions de filtres - Affiche les filtres disponibles lorsque vous tapez
- Saisie semi-automatique des catégories - Suggère des catégories par nom ou slug
- Saisie semi-automatique des étiquettes - Suggère des étiquettes avec le nombre de messages
- Saisie semi-automatique des noms d’utilisateur - Suggère des noms d’utilisateur avec des noms d’affichage
- Suggestions de dates - Propose des options de dates rapides (hier, semaine dernière, etc.)
- Support des préfixes - Affiche les options de préfixes pour les catégories et les étiquettes
Conseils et bonnes pratiques
- Utilisez la saisie semi-automatique - L’interface de filtre fournit des suggestions intelligentes lorsque vous tapez
- Combinez les filtres - Mélangez différents types de filtres pour des résultats précis
- Partagez les URL de filtre - Les URL de filtre sont partageables - copiez l’URL pour partager votre recherche
- Ajoutez des filtres utiles à votre barre latérale - Les URL de filtre peuvent être ajoutées à votre barre latérale pour un accès facile
- Utilisez l’exclusion - Utilisez le préfixe
-pour exclure les résultats indésirables - Raccourcis de date - Utilisez des nombres pour les dates relatives (30 = il y a 30 jours)
- Navigation au clavier - Utilisez les touches fléchées pour naviguer dans les suggestions, Tab/Entrée pour sélectionner
Création de liens de barre latérale personnalisés
Vous pouvez ajouter des liens de filtre à votre barre latérale en tant que liens personnalisés :
- Accédez aux paramètres de votre barre latérale
- Ajoutez un lien personnalisé avec une URL de filtre comme
/filter?q=catégorie:support statut:ouvert - Donnez-lui un nom descriptif comme « Sujets de support ouverts »
Notes techniques
- Le filtre utilise la recherche plein texte pour les mots-clés combinés avec des filtres
- La longueur minimale des termes de recherche s’applique aux recherches par mots-clés
- Les résultats tiennent compte des permissions - vous ne voyez que les sujets auxquels vous pouvez accéder
- Les requêtes de filtre sont traitées côté serveur pour des performances optimales
- La fonctionnalité prend en charge les extensions de plugin pour des filtres personnalisés