Skip to content

1. 用户字段(自定义用户资料项) ​

入口:后台 ?tool=userfields(「用户字段」)。

给注册表单 / usercp / 公开用户档案加自定义资料项——例如「常用 BT 客户端」「所在地区」「接收求种私信」。

六种字段类型 ​

类型值形状说明
text字符串 ≤500单行文本
number数字含上下限
select单选项选项在 options 里维护
multiselect多选项 ≤20同上
date日期YYYY-MM-DD
bool是/否开关

同一套类型语义与内容侧「维度」共用一个校验器(apps/api/src/fields.rs),两边行为一致。

每个字段可配 ​

  • required:注册时必填与否;
  • show_on_register:是否出现在注册表单;
  • visibility:公开(他人档案可见)/ 私密(仅本人与管理);
  • module_key:挂到某模块——模块一关,字段从前台三处(注册页/usercp/档案)一并下线;
  • sort / enabled:排序与启停。

行为要点 ​

  • 字段值存 JSONB(user_field_values),改类型不影响已存值读取,但重校验在新值写入时执行;
  • 删除字段前列表会显示「已填用户数」,心中有数再删;
  • 字段随全量配置导出/导入走(见升级手册),换机不丢。