使用手册

适用产品：在线表单收集系统 插件（ v0.0.1）
适用对象：网站管理员 / 运营人员

一、系统简介

formcollect 是一款面向数据收集场景的在线表单系统，主要能力包括：

• 可视化拖拽表单设计器：文本、数字、单选、多选、下拉、日期、评分、省市区、图片/文件上传等字段自由配置；
• H5 移动端适配填表页：适用于招生报名、线上预约、信息收集、活动/会议报名、问卷调查、意见反馈、求职应聘等场景；
• 多套填表页模板：内置通用简约、招生报名、线上预约、信息收集、活动会议、问卷调查、意见反馈、求职应聘等风格，系统按表单名称/业务场景自动推荐，也可在收集设置中手动切换；
• 每张表单独立动态数据表：后台统一管理、审核、导入与导出；
• 一键生成 iframe / JS 嵌入代码：可无缝嵌入第三方网站与公众号页面；
• 提交日志：自动记录每次提交的来源 IP、来源页与 UA，并区分「直链 / 嵌入」，便于排查与追溯；
• 收集控制：域名白名单、提交验证码、起止时间、提交次数限制、自动审核等。

二、进入系统

2.1 登录后台

1. 打开后台登录地址（默认 http://你的域名/admin.php，若已改名请使用新地址）。
2. 输入管理员账号与密码登录。

2.2 找到表单收集菜单

登录后，在后台顶部菜单中找到 「表单收集」，其下包含 「表单管理」 与 「提交日志」 两个子菜单。

若左侧没有该菜单，说明插件未安装或当前账号无权限：请先安装/启用 formcollect 插件，并在「权限管理」中为对应角色勾选表单收集相关权限。

三、表单管理（列表页）

进入「表单收集 → 表单管理」后，可以看到所有已创建的表单列表。

列表通常包含：表单名称、业务场景、提交数量、状态、创建时间、操作按钮等。

可执行的操作：

四、新建表单

1. 点击列表上方「添加」按钮。
2. 填写表单信息：

开始时间必须早于截止时间，否则保存会失败。

3. 点击「确定」保存。系统会：

   • 自动生成唯一的表单访问标识（form_key，随机串，防止被遍历猜测）；
   • 按所选场景创建初始字段，并写入表单设计器；
   • 按表单名称/业务场景预选一套「填表页模板」，可在设计器的收集设置中更换。

业务场景与预置字段

五、表单设计器（核心）

保存表单后，在列表点击「表单设计」进入设计器。设计器为三栏布局：

• 左栏：字段类型面板（点击或拖拽到画布添加字段）；
• 中栏：手机预览画布（实时预览填表效果）；
• 右栏：字段属性面板（选中字段后配置其属性）。

顶部按钮：「收集设置」（抽屉式设置面板）与「保存表单」。

5.1 字段类型

5.2 添加字段

两种方式任选：

• 在左栏点击字段类型，字段自动加入画布末尾；
• 把字段类型拖拽到画布中的目标位置。

5.3 配置字段属性

在画布中点击某个字段，右栏显示其属性面板。通用属性如下：

5.4 特殊字段的专属属性

评分组件：

图片上传 / 文件上传：

上传类字段的规则提示会自动拼接并展示在填表页，例如"最多 2 张图片，仅限 jpg/png，单个不超过 3MB"。

分组标题 / 说明文字：仅用于排版，不收集数据，可设置文字与图标。

5.5 排序与删除字段

• 在画布中拖拽字段可调整顺序；
• 在字段的属性面板或画布中提供删除入口，可移除字段。

5.6 保存表单

点击右上角「保存表单」。

• 首次保存：系统会依据字段自动创建该表单独立的动态数据表，并登记字段配置；
• 再次保存：系统会增量同步表结构与字段配置。

提示：至少需要配置一个可落库的字段（分组标题、说明文字不算），否则保存会提示"请至少配置一个数据字段"。

六、收集设置

在设计器点击右上角「收集设置」按钮，右侧弹出设置抽屉。所有外观改动会在中间手机画布实时预览。

6.1 基础与文案

6.2 填表页模板

在抽屉中的「填表页模板」下拉里选择整站风格。系统内置以下模板：

• 创建表单时系统会按表单名称关键词（如"招聘""问卷""预约"）匹配推荐模板；名称未命中时回落到所选业务场景对应的模板，都未命中则使用「通用简约」；
• 切换模板会自动套用该模板的推荐配色，之后仍可在下方「模板配色」中微调；
• 模板只决定填表页的外观风格，不影响字段、数据与收集规则。

6.3 外观（模板配色 / 背景图 / 封面图 / 卡片样式）

安全说明：本站图片地址仅支持 /upload/ 目录内图片或 http(s) 外链图片；填写非法地址会在保存时直接报错。

6.4 收集规则

域名白名单支持形如 www.a.com,*.b.com 的写法；跨域嵌入提交时会校验来源。

设置完成后点击抽屉下方「保存设置」。

七、预览与分享填表页

• 在「表单设计」页顶部点击 「预览填表页」，可在新窗口打开 H5 填表页；
• 在「嵌入代码」页可复制填表页链接，直接分享给用户，或放入公众号菜单/文章中跳转。

填表页特征：

• 顶部为表单名称与说明；
• 字段按设计顺序渲染，必填项带红色星号；
• 底部为提交按钮与底部描述；
• 适配手机端，支持日期、下拉、评分、省市区、图片/文件上传等控件。

八、嵌入第三方网站/公众号

在表单列表点击「嵌入代码」，进入嵌入页面，提供三种方式：

生成嵌入代码前，需先在设计器中保存字段；否则会提示"请先完成字段设计并保存"。

如需限制仅指定网站可嵌入，请先在「收集设置 → 嵌入域名白名单」配置域名。

九、数据管理

在表单列表中，点击某表单的「数据」进入其收集数据页面。

9.1 数据列表与筛选

页面顶部提供标签页筛选：

• 全部：所有收集记录；
• 待审核：审核状态为"待审核"的记录；
• 已通过：审核通过的记录；
• 未通过：审核未通过的记录。

9.2 添加 / 编辑 / 删除数据

• 点击「添加数据」可在后台手动录入一条数据；
• 点击某行的「编辑」可修改该条数据；
• 勾选数据后点击「删除」可批量删除（同时清理对应提交日志）。

9.3 数据审核

1. 勾选需要审核的一条或多条数据；
2. 点击「审核」按钮，在弹窗中选择审核结果（通过 / 未通过）；
3. 提交后审核状态更新。

若表单「收集设置 → 自动审核」选择"通过"，则新提交数据默认已通过，无需手动审核。后台手动添加/导入的数据审核状态同样受该设置影响。

9.4 数据导出

点击「导出」可导出收集数据为 Excel（.xlsx）：

• 可结合当前筛选范围导出（全部 / 待审核 / 已通过 / 未通过）；
• 导出字段为后台字段配置中标记为"导出"的字段；
• 导出文件名形如"表单名收集数据+时间戳.xlsx"。

十、提交日志

在后台左侧菜单进入 「表单收集 → 提交日志」，可查看所有表单的提交记录，用于排查与追溯。

• 记录内容：所属表单、来源 IP、来源页 URL、User-Agent、提交时间；
• 来源标识：自动区分「直链」（用户直接打开填表页）与「嵌入」（经 iframe / JS 在第三方页面提交）；
• 页面顶部可按表单筛选，支持勾选后删除日志。

删除日志仅移除追溯记录，不影响已收集的表单数据；但"每 IP 一次 / 每 IP 每天一次"等提交次数限制依赖日志计数，删除对应日志后该 IP 可重新提交。

十一、前台填写体验

访客打开填表页或嵌入页面后：

1. 按字段填写表单，必填项会做校验；
2. 如果开启了验证码，需填写图形验证码；
3. 如果设置了提交限制（每 IP 一次等），超限会收到提示；
4. 提交成功后展示"成功提示语"，也可自定义。

十二、常见问题（FAQ）