PageAdmin表单自定义,企业官网留言系统
企业官网的留言系统通常需要收集称呼、电话、需求描述等字段,PageAdmin 自带的表单功能可以通过后台自定义字段来满足。
下面按零基础能照做的顺序,讲清从添加字段到前端显示的完整过程,最后给出验证和排错方法。
先确认表单功能是否可用
登录 PageAdmin 后台,进入“表单管理”或“自定义表单”模块。
不同版本菜单名称略有差异,如果找不到入口,先检查当前账号是否有表单管理权限。
新建表单时,系统会要求填写表单名称和标识,标识建议用英文小写,例如 message,后续模板调用会用到。
创建完成后进入字段管理,开始添加企业留言需要的字段。
添加留言字段并设置验证
在字段管理页面逐个添加字段,常用配置如下:
- 字段名称:称呼
- 字段标识:
name - 字段类型:单行文本
- 是否必填:是
按同样方式添加电话、邮箱、需求描述。
电话字段类型选单行文本,验证规则可填手机号正则;
需求描述选多行文本,避免用户输入受限。
字段标识必须唯一,不要使用中文或空格,否则前端调用时容易出错。
字段添加完成后,回到表单列表确认字段顺序,前端会按这个顺序显示。
将表单嵌入企业官网页面
PageAdmin 通常提供两种调用方式:标签调用和模板文件调用。
如果后台有“表单调用代码”或“插入表单”按钮,直接复制生成的标签到栏目内容或单页中即可。
如果使用模板文件,找到对应的留言模板,例如 templates/当前模板/message.html,在需要显示表单的位置加入调用标签。
常见写法类似:
{pageadmin:form id="1"}
其中 id 是表单创建后系统分配的编号,以后台实际显示为准。
保存模板后,前台刷新留言页面,检查字段是否正常显示、必填项是否生效。
避坑:字段不显示或提交失败
遇到前台表单空白,先检查模板中调用的表单 id 是否和后台一致。
如果字段显示但提交后收不到数据,查看后台“表单数据”列表是否有记录。
常见原因包括:字段标识重复、必填项未填写、模板缓存未更新。
清理 PageAdmin 缓存后重新测试。
如果使用了 CDN,先刷新 CDN 缓存再验证。
涉及表单提交安全时,建议开启验证码或频率限制,避免被批量提交。
具体开关位置以当前 PageAdmin 版本后台显示为准。
验证留言系统是否可用
前台打开留言页面,填写称呼、电话和需求描述,点击提交。
页面提示成功后,回到后台表单数据列表,确认新记录已出现,并且字段内容与填写一致。
再测试一次不填必填项提交,确认系统会拦截并给出提示。
通过这两步,说明 PageAdmin 表单自定义和企业官网留言系统已经可以正常使用。
如果后续需要增加字段,重复字段管理步骤即可,已提交的数据不会丢失。