kuaigouzao-form 智能表单
v2 原生表单 提交记录安全独立 WordPress 表单插件,支持自定义表单构建
无需任何第三方服务,纯 WordPress 原生实现。
添加微信
扫码或搜索微信号添加
kuaigouzao-form 智能表单 —— 独立 WordPress 表单插件,支持自定义表单构建、提交数据管理与邮件通知。无需任何第三方服务,纯 WordPress 原生实现。



它能做什么
后台创建表单 → 通过短代码或 Gutenberg 区块投放到任意页面 → 访客填写提交 → 后台集中查看与管理提交记录,并可配置邮件通知。
后台新建表单(9 种字段,拖拽排序)
│ 保存
▼
短代码
无效的表单ID
或 Gutenberg 区块│ 投放到页面/文章
▼
访客填写提交(前端即时校验 + 后端二次校验)
│
▼
后台「提交记录」:查看 / 标记状态 / 备注 / 删除
│
▼
(可选)邮件通知管理员
功能特性
- 可视化表单编辑器:9 种字段类型,支持拖拽排序、上移/下移、折叠、复制字段、删除确认
- 双重校验:前端即时行内校验 + 后端保存前二次校验,双重保障
- 两种投放方式:短代码与 Gutenberg 区块,渲染同一表单,前台表现完全一致
- 提交记录管理:三种状态(已查看 / 已登记 / 无效)、管理员备注、单条与批量删除、筛选与分页
- 邮件通知:新提交即时推送,全局默认 + 表单级覆盖,收件人三级回退
- 反垃圾:隐藏 honeypot 字段 + 同 IP 提交频率限制(每分钟 10 次),填写出错不占配额
- 样式跟随站点:明暗主题自动跟随站点,主色与表单宽度可自定义,不污染站点全局样式
- 按需加载:样式与脚本仅在页面真正包含表单时加载,无表单页面零负载
- 数据自主:数据存自建数据表,卸载默认保留,可按需清理
安装
- 将本插件目录上传至
wp-content/plugins/(或在后台上传 zip 包) - 在「插件」页面启用 kuaigouzao-form 智能表单
- 启用时自动创建数据表,无需手动操作
- 左侧菜单出现「智能表单」:所有表单 / 新建表单 / 提交记录 / 插件设置
停用插件不会删除任何数据;只有卸载且勾选了「删除数据」选项时才会删表。
技术定位
| 维度 | 说明 |
|---|---|
| 技术栈 | AlpineJS v3 + TailwindCSS v4 + DaisyUI v5,前端零依赖原生 fetch,无 jQuery |
| 安全 | 所有接口 nonce 校验 + 权限校验;输出全部转义;SQL 统一预处理;防 ORDER BY 注入 |
| 兼容 | WordPress 6.5+(requires at least: 6.5)、PHP 7.4+、严格 SQL 模式服务器 |
| 国际化 | 文本域 kuaigouzao_form,翻译文件放 languages/ 即可生效 |
| 图标 | Lucide 内联 SVG,全静态资源内置,不引用任何 CDN |
一、适用范围
本须知适用于块构造在本站出售的全部数字产品与技术服务。
数字产品:WordPress 主题、插件及其授权。 技术服务:企业官网搭建、小程序开发、服务器运维、网站优化与推广。
二、交付方式
数字产品 付款后即时开通下载权限或发放授权码,交付内容包括:安装包、授权信息、安装说明。需要协助部署的,可在工作时间内提交工单,由我们远程协助。
技术服务 按项目节点交付。签约后提供需求确认单,开发完成后交付源码、后台账号与操作说明,验收通过即为交付完成。交付形式为线上交付,不提供线下介质。
三、授权范围
- 数字产品授权绑定购买时的域名或站点,一个授权对应一个站点。多站点使用需另行购买授权。
- 授权归购买方所有,可自用、可修改源码用于自身项目,但不得转售、不得再分发、不得用于二次开发后对外销售。
- 技术服务交付的源码与设计文件,版权在尾款结清后归委托方所有;我们保留在作品集、案例展示中使用的权利,如不希望展示请在签约时说明。
四、退款政策
数字产品 数字产品属于在线下载的数字化商品,依据《消费者权益保护法》第二十五条,不适用七日无理由退货。
未下载、未激活的订单,付款后 7 日内可申请全额退款;已下载或已激活的订单,除文件损坏、授权异常等功能性问题外,不予退款。功能性问题经核实后,可选择修复或退款。
技术服务
- 尚未开工:全额退款。
- 已完成需求确认、尚未进入开发:扣除已发生的方案与设计成本后退款。
- 已进入开发阶段:按已完成进度结算,剩余部分退还。
- 定制类项目开工后,因委托方单方面取消造成的损失,按合同约定处理。
五、价格与发票
站内标价为不含税价格,如需发票请在付款前告知抬头与税号,我们按实际开票类目开具。项目类服务以合同金额为准,站内标价仅作参考。
六、技术支持
- 数字产品提供 12 个月技术支持,范围为安装配置、功能使用、与常见环境的兼容问题。
- 技术服务提供 12 个月缺陷修复,范围为交付功能本身的错误;新增需求、界面改版、第三方平台规则变化导致的调整,另行报价。
- 响应时间:工作日 24 小时内答复。紧急故障(站点无法访问、支付异常)优先处理。
七、几点说明
- 我们不承诺任何搜索引擎或 AI 平台的收录、排名、引用结果,这类结果由平台规则决定,我们能做的是把技术基础做对。
- 因客户自行修改源码、安装第三方插件、未按说明升级环境导致的问题,不在免费支持范围内,可付费处理。
- 服务器、域名、短信、地图等第三方服务的费用与合规责任,由购买方承担。
八、联系与争议
购买前有疑问,建议先联系我们确认需求再下单。售后问题请通过站内工单或订单留言提交,我们按提交顺序处理。发生争议时,双方优先协商解决。
快速上手
- 进入「智能表单 → 新建表单」,填写表单标题
- 点击字段类型按钮添加字段,逐个设置标签、是否必填、占位提示;选择类字段需填写选项(每行一个)
- 在右侧「发布」框保存,保存后显示短代码,点击可复制
- 将短代码粘贴到任意页面、文章的正文即可展示表单(也可使用 Gutenberg 区块)
- 访客提交后,在「智能表单 → 提交记录」查看与管理
短代码与区块
短代码(属性只有 id,即表单 ID):
Gutenberg 区块:编辑器中插入「智能表单」区块,在侧栏下拉选择表单,画布内实时预览字段列表。表单后续修改无需重新插入,前台始终渲染最新配置。
短代码与区块渲染同一个表单,前端表现完全一致。
删除表单后,引用它的短代码/区块会显示「表单不存在」提示;区块编辑器中会提示重新选择。
短代码可粘贴到页面、文章、小工具等任意支持的位置;样式与脚本会自动加载。
字段类型与校验
| 类型 | 说明 | 校验规则 |
|---|---|---|
| 文本输入 | 单行输入 | 必填校验(可选必填) |
| 邮箱 | 邮箱输入 | 正则校验邮箱格式 |
| 手机号 | 手机号输入 | 中国大陆手机号(1 开头 11 位) |
| 多行文本 | 多行文本域 | 必填校验,保留换行 |
| 下拉选择 | 单选下拉 | 必填校验(默认「请选择」不可提交) |
| 单选按钮 | 单选组 | 必填校验 |
| 多选框 | 多选组 | 必填校验(至少勾选一项) |
| 日期 | 原生日期控件 | 必填校验 |
| 数字 | 数字输入 | 数字合法性校验 |
所有字段支持设置:标签、是否必填、占位提示。
- 前端校验即时反馈行内错误(红色边框 + 错误文案)
- 后端保存前做二次校验(前端校验可被绕过,以后端为准)
- 多行文本会保留用户输入的换行
表单编辑器
「新建表单 / 编辑表单」页面的字段操作:
- 添加字段:点击顶部的字段类型按钮
- 排序:拖拽字段卡片,或使用上移/下移按钮
- 折叠:字段较多时折叠已配置好的字段,保持编辑区清爽
- 复制字段:一键复制现有字段(标签自动加「(副本)」后缀)
- 删除字段:需二次确认
- 保存后:显示短代码并可一键复制;新建表单保存后地址栏自动带上表单 ID
校验规则:表单标题必填、至少一个字段、每个字段必须有标签、选择类字段必须填写选项、通知邮箱(如填写)需格式正确。
提交记录管理
「智能表单 → 提交记录」页面:
- 内容预览:列表直接显示前两个字段的值(每项最多 20 字),点击「查看」弹窗阅读全部内容
- 状态管理:三种状态 —— 已查看(默认)/ 已登记 / 无效,在编辑弹窗中一键切换
- 管理员备注:为每条记录添加内部备注,列表中直接可见
- 批量操作:勾选多条后批量删除,删除需二次确认
- 筛选与分页:按表单(从表单列表页点「提交数量」或从筛选框进入)与状态筛选,每页 20 条
邮件通知
有新提交时自动发送通知邮件。通知遵循「全局默认 + 表单级覆盖」:
| 表单的邮件通知设置 | 含义 | 是否发送 |
|---|---|---|
| 继承全局设置(默认) | 跟随插件设置里的全局开关 | 全局开启时发 |
| 强制开启 | 此表单必发 | 发送 |
| 强制关闭 | 此表单必不发 | 不发送 |
收件人三级回退:
表单单独填写的收件邮箱
→ 插件设置里的全局收件邮箱
→ 站点管理员邮箱(设置 → 常规)
邮件内容包含全部字段的名值对与提交时间。
建议同时安装 SMTP 插件配置发信,WordPress 默认的
wp_mail在多数主机上送达率不可靠。
插件设置
「智能表单 → 插件设置」:
| 设置项 | 说明 |
|---|---|
| 全局默认(邮件通知) | 开启后,所有未单独关闭通知的表单都发送通知邮件 |
| 通知邮箱 | 全局收件邮箱;留空则发送到站点管理员邮箱 |
| 前端主调色(默认) | 新建表单的默认主色(按钮、聚焦边框等),单表单可覆盖 |
| 前端表单宽度(默认) | 表单容器最大宽度,支持 px / rem / % 等 CSS 单位,如 512px、32rem、100% |
| 卸载选项 | 勾选后卸载插件时删除全部数据表(不可恢复,谨慎勾选) |
单个表单在编辑页可单独覆盖主色与宽度;未设置时继承上述默认值。
前端样式与主题适配
- 明暗主题:自动跟随站点主题(检测
data-theme/.dark标记),不跟随操作系统;站点切换主题时表单实时同步 - 主色注入:表单主色通过 CSS 变量
--kuaigouzao-primary注入,按钮、边框自动使用 - 宽度注入:容器宽度通过
--kuaigouzao-width注入 - 按需加载:样式与脚本仅在页面真正包含表单(短代码或区块)时加载,不影响其它页面速度
- 无需配置:不污染站点全局样式,DaisyUI 样式完全限定在表单容器内
常见问题
Q:前台提交提示「页面已过期,请刷新后重新提交」?
页面缓存导致表单里的安全令牌(nonce,有效期 12–24 小时)过期。刷新页面即可;若站点开启了页面缓存,建议对含表单的页面设置较短的缓存时间。
Q:提交提示「提交过于频繁,请稍后再试」?
同一 IP 每分钟最多 10 次提交。填写出错不会消耗配额,只有成功提交才计数。
Q:收不到通知邮件?
依次检查:① 表单的通知设置是「强制关闭」还是「继承全局」;② 全局开关与收件邮箱;③ 站点是否能发信(建议安装 SMTP 插件,如 WP Mail SMTP)。
Q:表单区域没有样式?
样式在检测到短代码/区块时自动加载。若表单出现在特殊位置(如某些缓存/构建插件处理过的内容),样式会在页脚兜底加载,首次打开可能有一瞬闪烁,属正常现象。
Q:旧版(kuaigongfang_form)的数据还在吗? 无效的表单ID
2.0.0 更名后数据表更名为 {prefix}kuaigouzao_forms / {prefix}kuaigouzao_form_entries,历史提交需按说明迁移;旧短代码 [kuaigongfang_form ...] 需替换为 。
卸载
- 若希望卸载时保留全部表单与提交数据:直接停用并删除插件即可(默认行为)
- 若希望卸载时删除全部数据:先到「插件设置」勾选「卸载插件时删除所有表单数据和提交记录」并保存,再执行卸载
- 无论哪种方式,插件自身的设置项都会被清理
- yuntrail_theme主题2.8.1发布说明 安全 计数写接口鉴权(P0):POST /wp-json/kgz/v1/{likes,views,shares} 的 permi…
- kuaigouzao-robots-llms-manager 1.0.7 技术说明 摘要:面向 WordPress 开发者的版本技术说明。1.0.7 主要解决了「从物理文件模式切回虚拟输出后,站点根遗留旧文件压制…
- kuaigouzao-form 智能表单|WordPress 原生轻量表单插件,线索收集高效又省心 摘要:专为 WordPress 站点打造的原生智能表单插件,纯本地实现无需第三方服务,轻量按需加载不拖站点速度,覆盖询盘、预约、…
- kuaigouzao-form 智能表单更新日志2.0.0 插件更名为 kuaigouzao-form,命名体系全面迁移(数据表、短代码、接口、样式前缀) 邮件通知重构:全局默认 + 表单…
选择块构造,理由足够震撼
专注 WordPress、ThinkPHP、uni‑appX 定制开发,从品牌视觉到线上推广,一站式落地你的数字化项目
- 全栈定制开发能力
- 深耕 WordPress、ThinkPHP、uni‑appX 开发,从网站到跨端应用,按需定制,拒绝模板化流水线产品。
- 品牌视觉一体化打造
- 平面设计配套建站服务,网站素材、宣传物料原创设计,品牌形象统一,强化客户记忆。
- 稳定高性能部署方案
- 服务器环境搭建、缓存与安全加固,全站多端适配,PC / 平板 / 手机访问稳定流畅,加载迅速。
- 一站式全链路技术托管
- 从品牌知识产权、广告投放,到网站运维迭代,全流程配套服务,交付后持续技术护航。