 |
摘要 | Discourse Chat 为您的 Discourse 实例添加了聊天功能。 |
 |
安装指南 | 该插件已随 Discourse 核心捆绑。无需单独安装该插件。 |
功能
正如我们在 初始公告、最新更新 和 线程化公告 中提到的那样，该插件为您的 Discourse 添加了聊天功能，使其能够原生支持在线社区的长篇和短篇沟通需求。
配置
初始设置
聊天功能默认对所有托管站点启用，但如果尚未启用，您可以前往 /admin/plugins 并切换开启该插件：
默认情况下，聊天功能仅对工作人员组可用，但您可以通过将其添加到“允许聊天的组”设置中来添加更多组。
频道保留策略
默认情况下，频道配置为保留消息 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。
由我们托管？ 聊天功能作为捆绑插件包含在内，适用于所有人。
