一、操作前置准备
你需要满足以下两个条件，才能进行后续操作：
- 已完成迅睿CMS的安装部署，可直接访问后台，官方最新版下载地址：
https://www.xunruicms.com/
- 拥有后台超级管理员权限，默认后台入口为：
你的域名/admin.php，输入账号密码登录即可
二、创建自定义字段全步骤
迅睿CMS自定义字段分为两类：绑定内容模块的字段（随文章、产品等内容使用）和全局配置字段（用于全站通用信息设置），创建流程一致，以下是分步操作：
1.进入自定义字段管理面板
登录后台后，依次点击顶部导航栏的扩展，再点击左侧菜单栏的自定义字段，即可进入字段管理列表页。
2.填写字段基础信息
点击列表页右上角的新建字段按钮，进入创建页面，依次填写以下核心信息：
- 字段名称：填写后台显示的中文名称，比如「文章封面图」「产品规格」，清晰即可，无格式限制
- 字段别名（调用标识）：必须符合规则：仅允许小写英文字母+数字，必须以字母开头，不能带特殊符号、中文，比如
article_cover、product_spec，这是后续模板调用的唯一标识，不能和已有字段重复
- 字段类型：根据使用场景选择，常用场景对应类型如下：
- 单行文本：短文本输入，比如作者名、外链地址
- 多行文本：长文本段落输入
- 图片上传：单张图片上传场景
- 多图上传：相册、轮播图等多图场景
- 下拉框：固定选项的单选场景
- 开关：是/否类型的布尔选择场景
示例：创建文章封面图字段，字段名称填「文章封面图」，别名填
article_cover，字段类型选「图片上传」即可。
3.配置字段验证与提示规则
基础信息填完后，下滑到字段参数配置板块，按需求配置必选项：
- 必填验证：如果该字段必须填写，开启「字段是否必填」选项，后台/前台投稿会自动验证不能为空
- 输入提示：在「字段说明」框填写内容要求，比如「建议尺寸1920800，大小不超过2M」，会显示在输入框下方提示编辑者
- 默认值：需要预设内容直接填写即可，新增内容时会自动填充
- 选项类配置：如果选了下拉框、复选框类型，在「选项列表」按行填写，格式为：
```
选项值=选项显示名称
new=全新
95new=九五新
old=二手
```
- 图片类配置：选择图片/多图类型时，在「上传配置」设置限制，大小单位为KB，限制2M直接填写2048即可，多图可设置最大上传数量
4.绑定字段到对应模块（关键步骤）
配置完参数后，下滑找到绑定信息板块，按场景选择绑定目标：
- 内容类字段（给文章、产品、页面加字段）：直接勾选对应的内容模块，比如给新闻模块加字段，勾选「新闻模块」即可
- 全局类字段（站点电话、备案号等全站通用信息）：绑定到「系统配置」模块，创建完成后会自动出现在「系统-系统配置」菜单中
所有信息填写完成后，点击页面底部的
保存按钮，字段就创建完成了。如果后台对应表单没有显示，点击顶部导航栏的「缓存-更新全部缓存」，刷新页面即可看到。
三、模板调用自定义字段方法（直接复制使用）
不同绑定场景的调用语法不同，以下是可直接复制的标准代码：
1.内容模块字段调用（文章、产品列表/详情页）
基础调用格式：
```
{$t.字段别名}
```
示例1：调用文章封面图（别名article_cover）输出img标签：
```
```
示例2：调用单行文本作者字段（别名author）：
```
作者：{$t.author}
```
示例3：多图上传字段（别名article_gallery）循环输出：
```
{loop $t.article_gallery $img}
{/loop}
```
2.全局自定义字段调用（全站通用信息）
基础调用格式：
```
{SITE.字段别名}
```
示例：调用站点电话字段（别名site_phone）：
```
联系电话：{SITE.site_phone}
```
四、常见问题排查
- 创建后后台看不到字段怎么办？：依次检查三个点：1.字段别名是否重复，重复会保存失败，需要修改别名重新创建；2.是否正确绑定了对应模块，未绑定不会显示；3.更新全部后台缓存，刷新页面即可显示
- 前端调用不显示内容怎么办？：依次检查：1.字段别名拼写是否和创建时一致，拼写错误无法输出；2.对应内容中是否填写了该字段的值，空白内容不会输出；3.更新全站缓存后再查看
- 可以修改已创建的字段吗？：除了字段别名不能修改，其他所有配置（名称、类型、规则、绑定模块）都可以修改，在字段列表点击编辑按钮修改后，保存更新缓存即可生效
- 删除字段会影响原有数据吗？：删除字段只会删除字段配置，不会影响原有内容的其他数据，不需要的字段直接删除即可
按照以上步骤操作，即可完成自定义字段从创建到调用的全流程，兼容迅睿CMS V4、V5所有正式版本。
