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