创建和配置自定义用户字段

[Discourse]

本指南介绍如何在 Discourse 中创建和配置自定义用户字段，包括如何将它们添加到注册表单、用户个人资料和用户目录中。

所需用户级别：管理员

自定义用户字段允许您从用户那里收集标准个人资料字段之外的额外信息。这些字段可以显示在用户卡片、用户摘要页面上，甚至可以使用 Data Explorer 插件进行检索。本指南将引导您完成创建和配置自定义用户字段的过程。

添加用户字段

1. 前往 管理 > 社区 > 用户字段 (discourse.example.com/admin/config/user-fields)。

2. 如果您尚未创建任何用户字段，您将看到此屏幕：
   

   

3. 点击“添加用户字段”按钮以添加一个新字段。
   

   

选择字段类型

字段类型决定了用户在注册表单中看到的输入字段。根据您要收集的信息类型进行选择：

文本字段

• 用于具有许多可能答案的简短问题（例如，“您在哪家公司工作？”）
• 显示为单行 HTML 文本输入
  
  

文本域 (Textarea)

• 用于可能需要较长、多行答案的问题（例如，“请介绍一下您自己”）
• 显示为多行 HTML 文本域输入

日期 (Date)

• 用于收集日期值（例如，“您的出生日期是？”）
• 显示为日期选择器输入

确认 (Confirmation)

• 用于是/否问题（例如，“您想订阅我们的新闻通讯吗？”）
• 显示为 HTML 复选框
  
  

下拉列表 (Dropdown)

• 用于具有固定数量可能答案的问题（例如，“您的性别是？”）
• 显示为 HTML select 输入
  
  

要为下拉列表字段添加选项：

1. 点击选项输入框
2. 输入一个答案并点击“创建”
3. 对更多选项重复此操作
   
   

完成后的选项应如下所示：

多选 (Multiselect)

• 用于用户可以从一组选项中选择多个答案的问题（例如，“您对哪些主题感兴趣？”）
• 显示为多选输入
• 选项的配置方式与下拉列表字段相同

设置字段名称和描述

• 字段名称 (Field Name)：显示在注册表单和用户个人资料的输入框之前
• 字段描述 (Field Description)：显示在输入框之后，以帮助用户填写该字段

字段名称和描述都是保存字段所必需的。

这是自定义字段在注册表单上的显示方式：

配置用户字段选项

字段要求 (Field Requirements)

• 可选 (Optional) - 可选字段可以留空
• 对所有用户 (For all users) - 当字段为所有用户必填时，所有帐户，包括已登录的用户，都将被强制填写。这在处理服务条款 (ToS) 要求等情况时非常有用。
• 注册时 (On signup) - 所有新帐户都将被要求填写该字段。

此外，在创建表单底部，您会找到以下偏好复选框：

• 注册后可编辑 (Editable after signup)：允许用户从其个人资料页面更新该字段
• 显示在公开个人资料上 (Show on public profile)：在用户的摘要页面上显示该字段的值
• 显示在用户卡片上 (Show on user card)：在用户卡片上显示该字段的值
• 可搜索 (Searchable)：启用根据此字段的值在用户目录中搜索用户
• 显示在注册表单上 (Show on signup form)：控制字段是否显示在注册表单上。当字段要求设置为“对所有用户”或“注册时”，或者字段在注册后不可编辑时，此项会自动启用（且无法禁用）。

显示在公开个人资料上 (Show on public profile)

启用后，字段值将显示在用户的个人资料页面上：

显示在用户卡片上 (Show on user card)

启用后，字段值将显示在用户卡片上：

可搜索 (Searchable)

启用后，您可以根据用户的自定义字段值进行搜索：

保存和编辑字段

1. 点击“保存”将字段添加到您站点的用户字段列表
2. 要编辑字段，请点击列表中的相应“编辑”按钮
3. 要删除字段，请点击其旁边的省略号菜单 (⋮) 并选择“删除”

将自定义字段添加到用户目录

1. 前往用户目录
2. 点击扳手图标：

3. 勾选您想要显示的自定义用户字段
4. 点击“保存”

选定的自定义字段现在将显示在用户目录表中：