Dieser Leitfaden erklärt das erweiterte Themafiltersystem von Discourse, einschließlich der vollständigen Syntax der Abfragesprache, Filteroptionen und wie die Route
/filtereffektiv genutzt wird.
Erforderliches Benutzerniveau: Alle Benutzer
Verwenden der Discourse-Themenfilter-Abfragesprache
Der Discourse-Themenfilter bietet eine leistungsstarke Abfragesprache zum Finden von Themen basierend auf mehreren Kriterien. Diese erweiterte Suchoberfläche ermöglicht es Ihnen, Filter zu kombinieren, Ergebnisse zu sortieren und präzise Abfragen für beliebige Inhalte in Ihrem Forum zu erstellen.
Zugriff auf den Filter
Sie können auf den Themenfilter auf zwei Arten zugreifen:
Direkter URL-Zugriff:
Navigieren Sie zu /filter auf Ihrer Discourse-Instanz (z. B.: https://meta.discourse.org/filter)
Seitenleistennavigation:
Klicken Sie in Ihrer Seitenleiste auf „Mehr“ und wählen Sie dann die Filteroption aus
Die Filteroberfläche enthält ein intelligentes Autovervollständigungssystem, das verfügbare Filter und Werte vorschlägt, während Sie tippen.
Grundlegende Abfragesyntax
Filter verwenden eine strukturierte Syntax mit dem Format:
filter-name:wert
Kombinieren mehrerer Filter:
category:support status:open created-after:2023-01-01
Einschließen regulärer Suchbegriffe:
category:support ssl certificate error
Dies sucht nach Themen in der Kategorie „Support“, die die Wörter „SSL-Zertifikatsfehler“ enthalten.
Kategorie-Filter
category: (Alias: categories:)
Themen nach Kategorie filtern
Grundlegende Verwendung:
category:support
category:dev,support # Themen in den Kategorien dev ODER support
category:documentation:admins # Themen in der Unterkategorie admins von documentation
Erweiterte Präfixe:
=- Kategorie ohne Unterkategorien:=category:general-- Kategorie ausschließen:-category:off-topic-=- Kategorie ohne Unterkategorien ausschließen:-=category:meta
Beispiele:
category:bug,feature # Kategorien bug oder feature einschließen (mit Unterkategorien)
=category:bug,feature # Kategorien bug oder feature einschließen (ohne Unterkategorien)
-category:bug,feature # Kategorien bug oder feature ausschließen (mit Unterkategorien)
-=category:bug,feature # Kategorien bug oder feature ausschließen (ohne Unterkategorien)
Tag-Filter
tag: (Alias: tags:)
Themen nach Tags filtern (erfordert, dass das Tagging aktiviert ist)
Grundlegende Verwendung:
tag:bug
tag:feature,enhancement # Themen mit den Tags feature ODER enhancement
tag:bug+urgent # Themen mit den Tags bug UND urgent
Ausschluss:
-tag:solved # Themen mit dem Tag solved ausschließen
-tag:bug+urgent # Themen mit den Tags bug und urgent ausschließen
-tag:bug,urgent # Themen mit den Tags bug oder urgent ausschließen
tag_group:
Nach Tag-Gruppen filtern
Grundlegende Verwendung:
tag_group:moderation
-tag_group:staff-only # Themen mit Tags aus der Gruppe staff-only ausschließen
Datumsfilter
Alle Datumsfilter unterstützen sowohl spezifische Daten (JJJJ-MM-TT) als auch relative Tage:
Aktivitätsdaten
activity-before:- Themen mit letzter Aktivität vor Datumactivity-after:- Themen mit letzter Aktivität nach Datum
Erstellungsdaten
created-before:- Themen erstellt vor Datumcreated-after:- Themen erstellt nach Datum
Neueste Post-Daten
latest-post-before:- Themen mit letztem Post vor Datumlatest-post-after:- Themen mit letztem Post nach Datum
Beispiele für Datumsformate:
created-after:2023-12-25 # Spezifisches Datum (JJJJ-MM-TT)
created-after:30 # Vor 30 Tagen
created-after:1 # Gestern
created-after:0 # Heute
Schnelle Vorschläge:
1- Gestern7- Letzte Woche30- Letzter Monat365- Letztes Jahr
Benutzerfilter
created-by:
Nach Thema-Autor filtern
Grundlegende Verwendung:
created-by:username
created-by:user1,user2 # Themen von user1 ODER user2
created-by:@username # @-Präfix ist optional
Persönliche Filter (nur für authentifizierte Benutzer)
in:
Nach Ihrer persönlichen Beziehung zu Themen filtern
Verfügbare Optionen:
in:pinned- Für Sie angeheftete Themenin:bookmarked- Von Ihnen gespeicherte Themenin:watching- Themen, die Sie beobachtenin:tracking- Themen, die Sie verfolgenin:muted- Von Ihnen stummgeschaltete Themenin:normal- Themen mit normaler Benachrichtigungsstufein:watching_first_post- Themen, bei denen Sie nur den ersten Beitrag beobachten
Beispiele:
in:bookmarked category:support
in:watching,tracking # Themen, die Sie beobachten ODER verfolgen
Numerische Filter
Like-Filter
likes-min:- Minimale Gesamtzahl von Likes über alle Beiträge hinweglikes-max:- Maximale Gesamtzahl von Likes über alle Beiträge hinweglikes-op-min:- Minimale Likes im Eröffnungsbeitraglikes-op-max:- Maximale Likes im Eröffnungsbeitrag
Beitragsanzahl-Filter
posts-min:- Minimale Anzahl von Beiträgenposts-max:- Maximale Anzahl von Beiträgen
Teilnehmer-Filter
posters-min:- Minimale Anzahl von Teilnehmernposters-max:- Maximale Anzahl von Teilnehmern
Aufrufe-Filter
views-min:- Minimale Anzahl von Aufrufenviews-max:- Maximale Anzahl von Aufrufen
Beispiele:
likes-min:10 # Themen mit mindestens 10 Likes
posts-min:5 posts-max:20 # Themen mit 5-20 Beiträgen
views-min:100 likes-op-min:5 # Beliebte Themen mit engagierten Eröffnungsbeiträgen
Statusfilter
status:
Nach dem Thema-Status filtern
Verfügbare Status:
status:open- Offene Themen (nicht geschlossen oder archiviert)status:closed- Geschlossene Themenstatus:archived- Archivierte Themenstatus:listed- Aufgelistete (sichtbare) Themenstatus:unlisted- Nicht aufgelistete Themenstatus:deleted- Gelöschte Themen (erfordert Berechtigung)status:public- Öffentliche Themen (nicht eingeschränkte Kategorien)
Plugin-spezifische Status:
status:solved- Gelöste Themen (mit Solved-Plugin)status:unsolved- Ungelöste Themen (mit Solved-Plugin)
Beispiele:
status:open category:support
status:closed created-after:30
Sortieroptionen
order:
Ergebnisse nach verschiedenen Kriterien sortieren
Verfügbare Sortierungen:
order:activity- Neueste Aktivität (Standard, absteigend)order:activity-asc- Älteste Aktivität zuerstorder:created- Erstellungsdatum (neueste zuerst)order:created-asc- Älteste zuerstorder:latest-post- Neuestes Post-Datumorder:latest-post-asc- Ältestes letztes Postorder:likes- Meiste Likes über alle Beiträge hinwegorder:likes-asc- Wenigste Likesorder:likes-op- Meiste Likes im Eröffnungsbeitragorder:likes-op-asc- Wenigste Likes im Eröffnungsbeitragorder:posters- Meiste Teilnehmerorder:posters-asc- Wenigste Teilnehmerorder:title- Alphabetisch nach Titelorder:title-asc- Umgekehrt alphabetischorder:views- Meiste Aufrufeorder:views-asc- Wenigste Aufrufeorder:category- Kategorienameorder:category-asc- Umgekehrter Kategorienameorder:read- Datum des letzten Lesens (authentifizierte Benutzer)order:read-asc- Ältestes Lesen zuerst
Erweiterte Beispiele
Beliebte aktuelle Diskussionen finden:
created-after:7 likes-min:10 order:likes
Support-Themen, die Aufmerksamkeit erfordern:
category:support status:open posts-max:3 created-after:7
Ihre gespeicherten Entwicklungsthemen:
category:dev in:bookmarked order:activity
Gelöste Bug-Reports ausschließen:
category:bug -tag:solved status:open order:created
Themen mit hohem Engagement von bestimmten Benutzern:
created-by:admin,moderator likes-min:5 views-min:100
Aktuelle nicht aufgelistete Themen (nur für Mitarbeiter):
status:unlisted created-after:30 order:created
Autovervollständigungsfunktionen
Die Filter-Eingabe bietet intelligente Vorschläge:
- Filtervorschläge - Zeigt verfügbare Filter an, während Sie tippen
- Kategorie-Autovervollständigung - Schlägt Kategorien nach Namen oder Slug vor
- Tag-Autovervollständigung - Schlägt Tags mit Beitragsanzahlen vor
- Benutzername-Autovervollständigung - Schlägt Benutzernamen mit Anzeigenamen vor
- Datums-Vorschläge - Bietet schnelle Datumsoptionen (gestern, letzte Woche usw.)
- Präfix-Unterstützung - Zeigt Präfix-Optionen für Kategorien und Tags an
Tipps und Best Practices
- Verwenden Sie Autovervollständigung - Die Filteroberfläche bietet intelligente Vorschläge, während Sie tippen
- Kombinieren Sie Filter - Mischen Sie verschiedene Filtertypen für präzise Ergebnisse
- Teilen Sie Filter-URLs - Filter-URLs sind teilbar - kopieren Sie die URL, um Ihre Suche zu teilen
- Fügen Sie nützliche Filter zu Ihrer Seitenleiste hinzu - Filter-URLs können für einfachen Zugriff zu Ihrer Seitenleiste hinzugefügt werden
- Verwenden Sie Ausschluss - Verwenden Sie das Präfix
-, um unerwünschte Ergebnisse auszuschließen - Datums-Kurzbefehle - Verwenden Sie Zahlen für relative Daten (30 = vor 30 Tagen)
- Tastaturnavigation - Verwenden Sie die Pfeiltasten, um Vorschläge zu navigieren, Tab/Enter zum Auswählen
Erstellen benutzerdefinierter Seitenleisten-Links
Sie können Filter-Links als benutzerdefinierte Links zu Ihrer Seitenleiste hinzufügen:
- Gehen Sie zu Ihren Seitenleisten-Einstellungen
- Fügen Sie einen benutzerdefinierten Link mit einer Filter-URL wie
/filter?q=category:support status:openhinzu - Geben Sie ihm einen beschreibenden Namen wie „Offene Support-Themen“
Technische Hinweise
- Der Filter verwendet Volltextsuche für Schlüsselwörter in Kombination mit Filtern
- Die Mindestlänge für Suchbegriffe gilt für Stichwortsuchen
- Ergebnisse sind berechtigungsbezogen - Sie sehen nur Themen, auf die Sie zugreifen können
- Filterabfragen werden zur Leistung auf der Serverseite verarbeitet
- Die Funktion unterstützt Plugin-Erweiterungen für benutzerdefinierte Filter