本指南将介绍如何在任何 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 将显示只有一帖的已关闭主题。
使用高级搜索页面
您还可以使用高级搜索页面通过图形用户界面构建这些 URL,然后复制生成的 URL。请注意,某些搜索过滤器可能无法在搜索上下文之外作为查询字符串参数工作。