Questa guida spiega il sistema avanzato di filtraggio degli argomenti di Discourse, inclusa la sintassi completa del linguaggio di query, le opzioni di filtro e come utilizzare efficacemente il percorso
/filter.
Livello utente richiesto: Tutti gli utenti
Utilizzo del linguaggio di query del filtro argomenti di Discourse
Il filtro argomenti di Discourse fornisce un potente linguaggio di query per trovare argomenti basati su criteri multipli. Questa interfaccia di ricerca avanzata ti consente di combinare filtri, ordinare i risultati e creare query precise per qualsiasi contenuto sul tuo forum.
Accesso al filtro
Puoi accedere al filtro argomenti in due modi:
Accesso diretto tramite URL:
Naviga su /filter nella tua istanza Discourse (ad esempio: https://meta.discourse.org/filter)
Navigazione dalla barra laterale:
Fai clic su “Altro” nella barra laterale, quindi seleziona l’opzione del filtro
L’interfaccia del filtro include un sistema di completamento automatico intelligente che suggerisce filtri e valori disponibili mentre digiti.
Sintassi di base delle query
I filtri utilizzano una sintassi strutturata con il formato:
nome-filtro:valore
Combina più filtri:
category:support status:open created-after:2023-01-01
Includi termini di ricerca regolari:
category:support ssl certificate error
Questo cerca argomenti nella categoria “support” contenenti le parole “ssl certificate error”.
Filtri per categoria
category: (alias: categories:)
Filtra argomenti per categoria
Utilizzo di base:
category:support
category:dev,support # Argomenti nelle categorie dev O support
category:documentation:admins # Argomenti nella sottocategoria admins di documentation
Prefissi avanzati:
=- Categoria senza sottocategorie:=category:general-- Escludi categoria:-category:off-topic-=- Escludi categoria senza sottocategorie:-=category:meta
Esempi:
category:bug,feature # Includi categorie bug o feature (con sottocategorie)
=category:bug,feature # Includi categorie bug o feature (senza sottocategorie)
-category:bug,feature # Escludi categorie bug o feature (con sottocategorie)
-=category:bug,feature # Escludi categorie bug o feature (senza sottocategorie)
Filtri per tag
tag: (alias: tags:)
Filtra argomenti per tag (richiede l’abilitazione dei tag)
Utilizzo di base:
tag:bug
tag:feature,enhancement # Argomenti con tag feature O enhancement
tag:bug+urgent # Argomenti con entrambi i tag bug E urgent
Esclusione:
-tag:solved # Escludi argomenti con tag solved
-tag:bug+urgent # Escludi argomenti con entrambi i tag bug e urgent
-tag:bug,urgent # Escludi argomenti con tag bug o urgent
tag_group:
Filtra per gruppi di tag
Utilizzo di base:
tag_group:moderation
-tag_group:staff-only # Escludi argomenti con tag dal gruppo staff-only
Filtri per data
Tutti i filtri per data supportano sia date specifiche (AAAA-MM-GG) che giorni relativi:
Date di attività
activity-before:- Argomenti con ultima attività prima della dataactivity-after:- Argomenti con ultima attività dopo la data
Date di creazione
created-before:- Argomenti creati prima della datacreated-after:- Argomenti creati dopo la data
Date dell’ultimo post
latest-post-before:- Argomenti con ultimo post prima della datalatest-post-after:- Argomenti con ultimo post dopo la data
Esempi di formato data:
created-after:2023-12-25 # Data specifica (AAAA-MM-GG)
created-after:30 # 30 giorni fa
created-after:1 # Ieri
created-after:0 # Oggi
Suggerimenti rapidi:
1- Ieri7- La settimana scorsa30- Il mese scorso365- L’anno scorso
Filtri utente
created-by:
Filtra per autore dell’argomento
Utilizzo di base:
created-by:username
created-by:user1,user2 # Argomenti di user1 O user2
created-by:@username # Il prefisso @ è opzionale
Filtri personali (solo utenti autenticati)
in:
Filtra in base alla tua relazione personale con gli argomenti
Opzioni disponibili:
in:pinned- Argomenti bloccati per tein:bookmarked- Argomenti che hai aggiunto ai preferitiin:watching- Argomenti che stai seguendoin:tracking- Argomenti che stai tracciandoin:muted- Argomenti che hai silenziatoin:normal- Argomenti con livello di notifica normalein:watching_first_post- Argomenti in cui segui solo il primo post
Esempi:
in:bookmarked category:support
in:watching,tracking # Argomenti che stai seguendo O tracciando
Filtri numerici
Filtri per like
likes-min:- Numero minimo di like totali in tutti i postlikes-max:- Numero massimo di like totali in tutti i postlikes-op-min:- Numero minimo di like nel post di aperturalikes-op-max:- Numero massimo di like nel post di apertura
Filtri per conteggio post
posts-min:- Numero minimo di postposts-max:- Numero massimo di post
Filtri per partecipanti
posters-min:- Numero minimo di partecipantiposters-max:- Numero massimo di partecipanti
Filtri per conteggio visualizzazioni
views-min:- Numero minimo di visualizzazioniviews-max:- Numero massimo di visualizzazioni
Esempi:
likes-min:10 # Argomenti con almeno 10 like
posts-min:5 posts-max:20 # Argomenti con 5-20 post
views-min:100 likes-op-min:5 # Argomenti popolari con post di apertura coinvolgenti
Filtri di stato
status:
Filtra per stato dell’argomento
Stati disponibili:
status:open- Argomenti aperti (non chiusi o archiviati)status:closed- Argomenti chiusistatus:archived- Argomenti archiviatistatus:listed- Argomenti elencati (visibili)status:unlisted- Argomenti non elencatistatus:deleted- Argomenti eliminati (richiede permessi)status:public- Argomenti pubblici (categorie non limitate)
Stati specifici del plugin:
status:solved- Argomenti risolti (con plugin Solved)status:unsolved- Argomenti non risolti (con plugin Solved)
Esempi:
status:open category:support
status:closed created-after:30
Opzioni di ordinamento
order:
Ordina i risultati in base a criteri diversi
Ordinamenti disponibili:
order:activity- Ultima attività (predefinito, decrescente)order:activity-asc- Prima attività più vecchiaorder:created- Data di creazione (più recenti prima)order:created-asc- Più vecchi primaorder:latest-post- Data dell’ultimo postorder:latest-post-asc- Ultimo post più vecchioorder:likes- Maggior numero di like in tutti i postorder:likes-asc- Minor numero di likeorder:likes-op- Maggior numero di like nel post di aperturaorder:likes-op-asc- Minor numero di like nel post di aperturaorder:posters- Maggior numero di partecipantiorder:posters-asc- Minor numero di partecipantiorder:title- Alfabetico per titoloorder:title-asc- Alfabetico inversoorder:views- Maggior numero di visualizzazioniorder:views-asc- Minor numero di visualizzazioniorder:category- Nome categoriaorder:category-asc- Nome categoria inversoorder:read- Data ultima lettura (utenti autenticati)order:read-asc- Prima lettura più vecchia
Esempi avanzati
Trova discussioni recenti popolari:
created-after:7 likes-min:10 order:likes
Argomenti di supporto che necessitano di attenzione:
category:support status:open posts-max:3 created-after:7
I tuoi argomenti di sviluppo aggiunti ai preferiti:
category:dev in:bookmarked order:activity
Escludi segnalazioni di bug risolti:
category:bug -tag:solved status:open order:created
Argomenti ad alto coinvolgimento da utenti specifici:
created-by:admin,moderator likes-min:5 views-min:100
Argomenti non elencati recenti (solo staff):
status:unlisted created-after:30 order:created
Funzionalità di completamento automatico
L’input del filtro fornisce suggerimenti intelligenti:
- Suggerimenti filtro - Mostra i filtri disponibili mentre digiti
- Completamento automatico categoria - Suggerisce categorie per nome o slug
- Completamento automatico tag - Suggerisce tag con conteggio post
- Completamento automatico nome utente - Suggerisce nomi utente con nomi visualizzati
- Suggerimenti data - Offre opzioni rapide per le date (ieri, settimana scorsa, ecc.)
- Supporto prefissi - Mostra opzioni di prefisso per categorie e tag
Suggerimenti e best practice
- Usa il completamento automatico - L’interfaccia del filtro fornisce suggerimenti intelligenti mentre digiti
- Combina i filtri - Mescola diversi tipi di filtri per risultati precisi
- Condividi gli URL dei filtri - Gli URL dei filtri sono condivisibili - copia l’URL per condividere la tua ricerca
- Aggiungi filtri utili alla tua barra laterale - Gli URL dei filtri possono essere aggiunti alla tua barra laterale per un facile accesso
- Usa l’esclusione - Usa il prefisso
-per escludere risultati indesiderati - Scorciatoie data - Usa numeri per date relative (30 = 30 giorni fa)
- Navigazione da tastiera - Usa i tasti freccia per navigare tra i suggerimenti, Tab/Invio per selezionare
Creazione di collegamenti personalizzati nella barra laterale
Puoi aggiungere collegamenti di filtro alla tua barra laterale come collegamenti personalizzati:
- Vai alle impostazioni della tua barra laterale
- Aggiungi un collegamento personalizzato con un URL di filtro come
/filter?q=category:support status:open - Dagli un nome descrittivo come “Argomenti di supporto aperti”
Note tecniche
- Il filtro utilizza la ricerca full-text per parole chiave combinate con i filtri
- Viene applicata la lunghezza minima del termine di ricerca per le ricerche per parole chiave
- I risultati sono consapevoli dei permessi - vedi solo gli argomenti a cui puoi accedere
- Le query del filtro vengono elaborate lato server per prestazioni ottimali
- La funzionalità supporta estensioni di plugin per filtri personalizzati