发送批量用户邀请

[Discourse]

本指南介绍如何使用批量邀请功能将多个用户邀请到您的 Discourse 实例。

所需用户级别：管理员

如果一次邀请一个用户，将大量用户邀请到您的 Discourse 实例可能会非常耗时。幸运的是，Discourse 提供了一个批量邀请功能，允许您一次邀请多个用户。本指南将引导您完成发送批量邀请的过程。

无法将用户邀请到预定义组，例如信任级别组、管理员、版主或工作人员组。作为一种变通方法，您可以在组的配置页面的“效果”部分配置一个自定义组，以自动设置用户的信任级别。这样做将允许您将受邀用户的信任级别设置为除您的站点“默认受邀者信任级别”设置之外的其他信任级别。

概述

1. 确保启用了 Allow bulk invite（允许批量邀请）站点设置（默认启用）
2. 准备包含用户信息的文件（CSV 格式）
3. 将 CSV 文件上传到您的 Discourse 实例
4. 监控批量邀请进度

确保 Allow bulk invite 站点设置已启用

Allow bulk invite 设置默认是启用的。如果您的站点已禁用此设置：

1. 导航到您的站点设置中的 Admin > All site settings，然后搜索 bulk invite。或者转到 {your.domain.com}/admin/site_settings/category/all_results?filter=bulk%20invite
2. 如果尚未启用，请勾选 Allow bulk invite 旁边的框，然后单击复选标记以保存站点设置。

准备 CSV 文件

第一步是创建一个 CSV（逗号分隔值）文件，其中包含您想要邀请的用户的信 息。以下是您需要了解的内容：

• 每行代表一位用户
• 电子邮件地址是必需的，并且必须位于第一列
• 组分配（可选）放在第二列
• 特定主题 ID（可选）放在第三列
• 区域设置（可选）放在第四列
• 任何额外的列可用于设置自定义用户字段值（列标题必须与用户字段名称匹配）

CSV 文件的结构如下：

email,groups,topic_id,locale

CSV 文件指南

• 电子邮件地址必须有效
• 使用分号分隔多个组（例如 group_1;group_2;group_3）
• 您可以包含现有用户，如果您想将他们添加到组中
• 只有电子邮件是必填项；组、主题 ID、区域设置和用户字段是可选的
• 如果包含自定义用户字段，CSV 必须有一个以 email 开头的标题行

有一个隐藏的站点设置 max_bulk_invites，默认允许 CSV 中有 50k 行。

CSV 文件示例

user1@example.com,group_1;group_2,topic_id
user2@example.com,group_3,
user3@example.com,,

您可以使用 Microsoft Excel 或 Google Sheets 等电子表格软件轻松创建 CSV 文件。以下是它在电子表格中可能的外观示例：

确保完成后将文件保存为 CSV 格式。

Google Sheets 中的逗号分隔 CSV 格式

Microsoft Excel 中的逗号分隔 CSV 格式

上传 CSV 文件

准备好 CSV 文件后，请按照以下步骤上传：

1. 导航到管理员用户个人资料中的“邀请”选项卡。{your.domain.com}/my/invited/pending

2. 点击“通过文件批量邀请”按钮
   

   

3. 在出现的模态框中，上传您的 CSV 文件
   

   

4. 确认上传

上传后，您将收到确认消息，告知您该过程完成后将收到通知。

监控批量邀请进度

CSV 文件处理后，您将收到包含进度报告的私人消息通知。该报告将包括：

• 发送的邀请总数
• 未发送的邀请数量（如果有）
• 过程中发生的任何错误

您可以查看个人资料中的邀请页面，查看已成功发送的邀请列表。

接下来会发生什么

CSV 文件中的每个电子邮件地址都将收到一封邀请邮件。该邮件将包括：

• 发送邀请人的姓名
• 您的社区名称
• 对您社区的简短描述（来自 site description 设置）
• 邀请链接

当受邀用户点击确认链接时：

• 他们的帐户将立即激活并与他们的电子邮件地址关联
• 他们将被添加到指定的组中（如果 CSV 中包含任何组）
• 他们将被定向到目标主题（如果指定了主题 ID）

未点击的邀请将根据 invite expiry days（默认：90 天）设置过期。

自定义邀请邮件

如果您希望自定义邀请邮件的文本：

• 对于一般邀请，请编辑“Invite Forum Mailer”邮件模板
• 对于包含特定主题 ID 的邀请，请编辑“Invite Mailer”邮件模板

附加资源

• Adding users from groups to other groups in bulk