このガイドでは、あらゆる Discourse サイトでカスタムフィルタリングされたトピックビューを取得するためにクエリ文字列を使用する方法を説明します。クエリ文字列は、すべてのユーザーが特定のトピックリストを表示したり、ユニークなトピックリストのカスタムリンクを作成したり、特定の基準を満たすトピックを検索したりするために使用できます。
必須ユーザーレベル: 全ユーザー
クエリ文字列は、ほとんどの Discourse URL の末尾に追加できるテキストで、カスタムフィルタリングされたトピックビューを取得できます。特定のトピックリストの表示、ユニークなトピックリストのカスタムリンクの作成、特定の基準を満たすトピックの検索に役立ちます。
クエリ文字列の理解
クエリ文字列は、URL の末尾に疑問符 (?) で始まり、その後にパラメータとその値が続きます。たとえば、次のようになります。
https://meta.discourse.org/?status=open
この URL では、?status=open がクエリ文字列です。
クエリ文字列を使用した場合に表示されるトピックのリストは、引き続きユーザーアカウントからアクセス可能なトピックに限定されます。クエリ文字列を使用するために有効にする必要がある設定はありません。
使用可能なクエリ文字列パラメータ
すべての Discourse サイトで使用できるクエリ文字列パラメータを次に示します。
ステータス
?status=_ を使用して、特定のステータスのトピックを表示します。
open: 開いているトピックのみclosed: 閉じているトピックのみarchived: アーカイブされたトピックのみunlisted: リストにないトピックのみdeleted: 削除されたトピックのみ
検索
?search=_ を使用して、検索結果の全ページを作成します。_ を検索用語に置き換えます。
状態
?state=_ を使用して、特定の状態のトピックを表示します。
muted: ミュートしたトピックを表示normal: 通常に設定したトピックを表示tracking: トラッキングしているトピックを表示watching: ウォッチしているトピックを表示
昇順
?ascending=true を使用して、トピックを日付の昇順で表示します。デフォルトは降順です。
並べ替え
?order=_ を使用して、さまざまな基準でトピックを降順で表示します。
likes: いいねの数でop_likes: 元の投稿のいいねの数でviews: 表示回数でposts: 投稿数（返信数）でactivity: 最終アクティビティの日付で（bumped_at日付を含む）posters: 参加者数でcategory: カテゴリ名で（Z-A）created: トピック作成日（新しいトピックから順）で
投稿数フィルター
?max_posts=_:_以下の投稿数のトピックを返します?min_posts=_:_以上の投稿数のトピックを返します
トピック ID
?topic_ids=_ を使用して、特定の ID のトピックのリストを表示します。カンマ区切りのトピック ID 文字列を受け入れます。
カテゴリ
?category=_ を使用して、特定のカテゴリのトピックのリストを表示します。カンマ区切りのカテゴリ ID 番号の文字列を受け入れます。
タグ
?tags=_ を使用して、タグでトピックをフィルタリングします。たとえば、https://meta.discourse.org/?tags=how-to は、how-to タグが付いたすべてのトピックを表示します。
プラグイン固有のパラメータ
一部のプラグインは、追加のクエリ文字列パラメータを追加します。
Solved プラグイン
Solved プラグインがインストールされている場合：
?solved=yes: 解決済みのトピックを表示?solved=no: 未解決のトピックを表示
Assign プラグイン
Assign プラグインがインストールされている場合：
?assigned=username: 特定のユーザーに割り当てられたすべてのトピックを表示?assigned=*: すべてのユーザーに割り当てられたすべてのトピックを表示?assigned=me: 現在のユーザーに割り当てられたすべてのトピックを表示?assigned=nobody: 未割り当てのすべてのトピックを表示
クエリ文字列の組み合わせ
アンパサンド (&) を使用して、複数のクエリ文字列を組み合わせることができます。複数のクエリ文字列を使用する場合、最初のパラメータのみに ? シンボルが必要です。たとえば、次のようになります。
https://meta.discourse.org/?max_posts=1&status=closed
この URL は、投稿数が 1 つだけの閉じているトピックを表示します。
高度な検索ページの利用
高度な検索ページを使用して、これらの URL をグラフィカルユーザーインターフェイスで構築し、結果の URL をコピーすることもできます。一部の検索フィルターは、検索コンテキスト外ではクエリ文字列パラメータとして機能しない場合があることに注意してください。
