||||
| 摘要 | Discourse Chat 为您的 Discourse 实例添加了聊天功能。
| 安装指南 | 此插件已与 Discourse 核心捆绑。无需单独安装插件。
功能
正如我们在最初公告和最新更新中所述，此插件为您的 Discourse 添加了聊天功能，因此它可以原生支持您在线社区的长期和短期沟通需求。
配置
初始设置
前往您的 /admin/plugins 页面，点击聊天 
设置 按钮。
在该页面上，可以通过勾选 chat enabled 站点设置来启用聊天。默认情况下，聊天仅对工作人员组可用，但您可以将它们添加到 chat allowed groups 设置中，以添加更多组（或向所有人开放）。
频道保留
默认情况下，频道配置为保留消息 90 天，直接消息配置为永久保留，但这些都是可配置的站点设置：
chat channel retention days（默认 90 天）
选择保留频道聊天消息的时长chat dm retention days（默认永久）
选择保留个人聊天消息的时长
其他站点设置
其他站点设置允许您配置一组默认表情符号反应和一系列安全功能（例如每秒最大聊天消息数、最小消息长度、静默时长以及是否允许上传）。
访问频道和创建新频道
启用插件后，标题中会出现一个搜索图标旁边的对话气泡，点击它将打开您的全屏聊天窗口，您可以在其中访问默认频道以及开始新的个人聊天。要从每个频道内部导航回全屏聊天窗口，请使用左上角的 << 图标。
使用任何聊天窗口上的 
按钮，您可以在全屏模式和抽屉模式之间切换。
创建频道
要创建新频道（仅限工作人员），请选择“全屏”聊天窗口右上角的 图标，然后选择 创建频道。选择一个要关联的类别，为其命名，并添加一个可选的描述以显示在“浏览频道”页面上。
一个类别可以关联多个频道，并且可以随时添加更多频道。由于频道始终链接到类别，因此您可以依赖现有的类别权限来自动限制谁可以访问该特定对话。
想要一个仅供您的 TL3+ 用户使用的频道吗？那么为您的 Lounge 类别创建一个新频道即可实现。
加入频道
您可以从“浏览频道”页面预览和加入频道。在此页面上，您可以查看所有对您可见且有资格加入的频道，还可以使用铃铛图标中的选项来控制每个频道的通知。
邀请用户加入频道
@提及单个用户或组将提供邀请他们加入频道的选项，前提是他们还不是参与者。要通过此方式邀请组，必须将组的“谁可以 @提及此组？”在组的 /manage/interaction 页面上设置为“无人”以外的值。
关闭和删除频道
管理员和版主可以从频道设置页面关闭或删除频道，该页面可以通过单击频道标题中的频道名称来访问。已关闭的频道可以随时重新打开，但删除频道是不可逆的，因此有一个额外的确认检查。
开始个人聊天
要开始个人聊天，请使用全屏聊天窗口上的 
图标，然后开始将用户名添加到收件人列表中。要离开个人聊天，请单击频道名称旁边的 X 图标（仅在桌面版上）。
如果您不小心离开了个人聊天，与同一个人/多人开始新的聊天将链接回之前发送的消息。
聊天内选项
与主题一样，聊天消息支持：
- 编辑
- 回复
- 引用
- Oneboxing
- 反应
- 书签
- 删除
在撰写框中，您可以插入日期、上传文件和 GIF！聊天频道支持频道范围内的 @here 和 @all 提及，并具有每个频道的功能，例如在线用户的绿色光环和 用户名正在输入… 指示器。
您还可以选择一条或多条聊天消息，然后“引用到主题”，以快速对话并将其转换为 Discourse 主题以进行深入讨论。
管理员和版主还可以选择聊天消息并将其移动到其他频道。
自动将用户添加到频道
聊天信息面板
单击频道标题现在将使用户进入一个包含三个选项卡的有用信息面板：
- 关于选项卡将显示标题、描述和链接的类别，以便用户了解每个频道的上下文。
- 成员选项卡允许用户查看房间里还有谁（成员列表和总数）。它包含一个过滤器，以便他们可以使用搜索。
- 设置选项卡将允许您设置通知偏好（静音、桌面/移动推送通知）。对于管理员来说，此选项卡还包括自动加入模式切换。
聊天偏好设置
启用聊天后，用户会在其偏好设置中看到一个新的 /preferences/chat 页面。在此页面上，他们可以选择退出聊天、选择退出 @here 和 @all 通知、管理其聊天电子邮件通知或选择桌面声音。
/preferences/users 页面上现有的设置也适用于聊天直接消息，因此用户还可以关闭直接消息或静音或忽略其他个人用户。
集成
Discourse Chat 支持传入 Webhook，但尚不支持交互式机器人或斜杠命令。
使用传入 Webhook（兼容 Slack）发送聊天消息
创建 Webhook 的界面位于“管理员”>“插件”>“聊天”> 新建传入 Webhook。您可以为每个 Webhook 配置名称、描述、用户名（发布消息的用户）、目标频道和表情符号。
由我们托管？ 聊天是包含在内的捆绑插件，适用于所有人。
