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