帝国CMS自定义表单全流程实操教程 含字段配置与数据调用方法

前置准备

确保你已经部署好帝国CMS7.2/7.5正式版本，后台默认登录地址为你的域名/e/admin/，使用安装时设置的管理员账号密码登录即可。

第一步：后台创建自定义表单核心配置

1.1 进入自定义表单管理页

登录后台后，点击顶部导航栏的【系统】选项，在左侧菜单栏依次找到【插件】→【自定义表单】→【管理自定义表单】，点击进入配置页。

1.2 基础参数配置

点击页面右上角的增加自定义表单按钮，按以下规则填写参数：

• 表单名称：填写业务相关名称，如「2024年线下活动报名表单」
• 数据表名：仅可使用英文+数字组合，不可加特殊符号，如activity_enroll，系统会自动拼接表前缀，无需手动添加
• 提交验证码：建议勾选开启，可拦截90%以上的垃圾机器人提交
• 提交后返回地址：填写提交成功后的跳转页面，如首页/，或自定义成功页地址
• 是否需要审核：若提交数据需后台校验后再展示，勾选「是」；仅做收集无需展示选「否」
• 前台提交权限：允许游客提交选「所有访问组」，仅会员可提交选对应会员组即可

所有参数填写完成后点击「提交」即可完成表单基础创建。

第二步：自定义表单字段添加与配置

2.1 进入字段管理页

提交后自动返回自定义表单列表，找到你刚创建的表单，点击操作栏的管理字段按钮进入字段配置页。

2.2 新增字段规则

点击右上角增加字段按钮，按业务需求配置每个字段，核心参数说明：

• 字段名：仅支持英文+数字，如username、phone，不可重复
• 字段标识：前台页面展示的字段名称，如「姓名」「手机号」
• 字段类型：根据字段属性选择，常用类型：单行文本(varchar)用于姓名/手机号、多行文本(text)用于留言/备注、单选/下拉框用于选项类内容、文件/图片类型用于附件上传
• 字段长度：单行文本普通字段填20-50即可，手机号固定填11，邮箱填50
• 是否必填：必填项勾选「是」，非必填选「否」
• 前台表单显示：必须勾选，否则前台用户无法看到该字段
• 验证规则：可选择系统预设规则，如手机号选「匹配手机号」、邮箱选「匹配邮箱」，错误提示框填写对应的报错文案，如「请输入正确的11位手机号」

注意：提交按钮无需单独添加字段，系统会自动生成，无需额外配置。所有字段添加完成后，可在字段管理页拖动调整字段的展示顺序。

第三步：前台表单页面生成与部署

3.1 获取官方原生表单代码

回到自定义表单列表，点击对应表单操作栏的预览按钮，打开预览页面后右键查看源代码，复制从

标签开头到

标签结尾的全部代码。

3.2 部署到站点页面

将复制的表单代码粘贴到你需要展示表单的模板文件对应位置，如首页模板/template/default/index.temp.php、自定义单页模板等。核心注意事项：

• form标签的action属性默认值为/e/enews/index.php，请勿修改，否则会提交失败
• 如果表单包含文件/图片上传字段，必须给form标签添加enctype="multipart/form-data"属性，否则文件无法正常上传
• 表单内的隐藏input字段（如enews、formid）请勿删除，否则会触发权限报错
• 你可以自行给表单添加CSS样式美化，不会影响提交功能

模板修改完成后，进入后台【数据更新】→【更新首页HTML】/【刷新所有页面】，即可在前台看到表单。

第四步：提交数据管理与导出

4.1 数据查看与处理

回到自定义表单列表，点击对应表单操作栏的管理信息按钮，即可看到所有用户提交的数据，支持单条/批量审核、编辑、删除操作。

4.2 数据导出

点击管理信息页面顶部的导出数据按钮，选择导出格式（Excel/CSV），勾选需要导出的字段，点击确认即可下载全部数据，无需借助第三方工具。

已审核数据前台调用方法

如果需要在前台展示已经审核通过的表单数据，可直接使用帝国CMS灵动标签调用，以下为可直接复制的代码示例：

``` [e:loop={'select from [!db.pre!]form_activity_enroll where checked=1 order by id desc',10,24,0}]

报名人： | 联系电话： | 报名时间：

[/e:loop] ```

参数说明：form_activity_enroll替换为你自己创建的表单数据表名，10为调用的条数，checked=1表示仅调用已审核通过的数据，字段名替换为你自己配置的字段即可。

常见问题解决方案

• 问题1：提交表单提示「您来自的链接不存在」
  解决方法：检查表单内是否包含两个隐藏字段：和，表单ID可在自定义表单列表的ID列查看，缺少的话手动添加即可。
• 问题2：上传文件/图片提交失败
  解决方法：首先确认form标签已添加enctype="multipart/form-data"属性，其次进入后台【系统设置】→【附件设置】，检查是否允许你上传的文件格式、大小是否符合限制。
• 问题3：收到大量垃圾提交
  解决方法：除了开启验证码，可在表单内添加隐藏字段：，正常用户看不到不会填写，机器人会自动填充，在/e/enews/index.php顶部添加判断：如果$_POST['honeypot']不为空则直接终止请求即可。
• 问题4：提交提示「没有权限提交该表单」
  解决方法：进入自定义表单编辑页，检查「前台提交权限」是否设置为「所有访问组」，如果仅限会员提交，确保用户已经登录对应会员组。