|||
|-|-|-|
| 
| 摘要 | 此主题组件允许用户屏蔽关键字。需要先在管理员设置中创建三个自定义用户字段才能正常工作。
| 
|预览| 我无法在主题创建器中预览此功能，因为它需要创建用户字段，但我已在下方附上屏幕截图。 |
| : hammer_and_wrench:|仓库| Github - a-very-old-sock/discourse-keyword-block |
| 
|安装指南|如何安装主题或主题组件|
| 
|刚接触 Discourse 主题？| Discourse 主题使用入门指南
安装此主题组件
此主题组件允许用户屏蔽关键字，这些关键字由用户在“首选项”>“个人资料”中指定。需要先在管理员设置中创建三个自定义用户字段才能正常工作。
在主题标题或主题摘要中屏蔽关键字：
屏蔽包含关键字的主题或回复帖子，以及包含关键字的建议主题：
此主题组件允许单个用户指定他们不想看到的内容的关键字，并隐藏包含该关键字的主题和回复帖子，同时提供一个显示链接。已关注的词语是一个管理员设置，适用于所有用户和整个站点；这允许单个用户指定他们不想看到的内容的关键字。
例如：一个宠物论坛可能有一个关于处理宠物毛发的一般性主题，但主要主题没有标记特定种类的动物。用户 A 回复了关于他们的狗的内容，用户 B 回复了关于他们的猫的内容，但用户 A 完全不想看到任何关于猫的内容。此主题组件允许用户 A 将“猫”添加到他们的屏蔽列表中，然后在任何地方，“猫”出现在主题或回复中，都会被替换为“已屏蔽，因为包含猫”，并附带一个可点击的显示链接。
用户必须在“首选项”>“个人资料”的自定义用户字段中指定一个逗号分隔的屏蔽关键字列表，并且可以指定关键字是否区分大小写或必须匹配整个单词。（区分大小写和全词匹配适用于整个屏蔽列表，而不是单个关键字）。
此主题组件要求您在“管理员”>“自定义”>“用户字段”中创建三个自定义用户字段才能正常工作。默认情况下，主题组件设置期望这些用户字段按以下顺序排列：1、2 和 3。如果您定义了其他自定义用户字段，则需要在主题组件设置中输入正确的用户字段编号。（用户字段编号从 1 开始，因此请向下计数您已定义的其他用户字段的数量）。有关更多详细信息，请参阅 Meta 创建和配置自定义用户字段指南。
1 - 用户的屏蔽词列表
字段类型：文本字段
字段名称：（任何名称都可以）屏蔽词
字段描述：（任何描述都可以）屏蔽帖子或主题中出现的词语或短语。逗号分隔。要屏蔽用户名，请在选择了全词匹配的情况下包含 @。
注册后可编辑
注册时必填
显示在公开个人资料上
显示在用户卡上
可搜索
2 - 区分大小写
字段类型：确认
字段名称：（任何名称都可以）屏蔽词 - 区分大小写
字段描述：（任何描述都可以）“屏蔽词”列表中的词语区分大小写。
注册后可编辑
注册时必填
显示在公开个人资料上
显示在用户卡上
可搜索
3 - 搜索全词或部分词
字段类型：确认
字段名称：（任何名称都可以）屏蔽词 - 全词
字段描述：（任何描述都可以）屏蔽词必须是完整的单词，而不是部分单词。
注册后可编辑
注册时必填
显示在公开个人资料上
显示在用户卡上
可搜索
下面的 CSS 已包含在主题组件中，它将阻止在注册表单上显示任何自定义用户字段。如果您有其他希望在注册表单上显示的自定义用户字段，则需要用自己的自定义 CSS 覆盖它。
.login-form .user-fields {
display: none;
}
我只在默认主题上测试过此功能。当类别设置为显示“类别/最新”和“类别/热门”时，会屏蔽帖子和主题，但在“类别/精选”或任何框式类别视图中则不会。我不太可能更改此设置，因为我自己的站点不需要它，但欢迎提交拉取请求。
此功能目前仅屏蔽在浏览器中可见的标题或摘要中包含关键字的帖子。我一直无法弄清楚如何在查看搜索结果或主题列表时检查整个帖子的内容，但我很乐意听取任何有关如何实现此功能的想法。
我打算让此功能也能在全页搜索视图中运行，但截至 2023 年 2 月 24 日，我目前正在努力使其正常工作。如果我能够让搜索屏蔽生效，我会在此处进行编辑。
此功能兼容“主题摘要”主题组件；它不兼容“主题列表预览”。我没有对其他主题组件进行广泛测试。
但当然——这可能与某些其他组件或插件发生冲突。