网站留言管理
📅 2026-11-21
👁️ 0
网站留言管理
网站留言管理用于查看和导出用户提交的留言,并维护留言表单的字段。
入口路径
后台顶部菜单 →「功能」→「互动/留言」→「网站留言管理」。实际地址:/system/plugin/interaction/guestbook,需要管理员权限(canAdmin)。
功能说明
列表展示留言时间、用户名、联系电话、Email、留言内容、IP、状态和操作;提供「导出留言」和「网站留言设置」两个入口。
界面截图

截图来自演示环境,表格可能处于空数据状态;字段位置与操作入口以当前后台界面为准。
列表字段说明
| 字段 | 含义 | 取值或来源 | 对操作的影响 |
|---|---|---|---|
| 时间 | 提交时间 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 用户名 | 留言者称呼 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 联系电话 | 留言者电话 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 留言者邮箱 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 | |
| 留言内容 | 留言正文 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| IP | 提交 IP | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 状态 | 未处理 / 已处理 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 操作 | 查看详情、删除等 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 | |
| :— | :— | :— | :— |
| 时间 | 提交时间 | — | 按业务节奏设置,参考默认值 |
| 用户名 | 留言者称呼 | — | 填便于识别的名称,与前台展示保持一致 |
| 联系电话 | 留言者电话 | — | 填真实可用的信息,格式需符合平台要求 |
| 留言者邮箱 | — | 填真实可用的信息,格式需符合平台要求 | |
| 留言内容 | 留言正文 | — | 简明描述,避免空泛 |
| IP | 提交 IP | — | 填真实可用的信息,格式需符合平台要求 |
| 状态 | 未处理 / 已处理 | — | 按业务需要选择启用或停用 |
| 操作 | 查看详情、删除等 | — | 按需点击对应操作 |
设置项说明(网站留言设置)
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 留言成功提示 | 提交成功后显示的话术 | 文本,默认「感谢您的留言!」[源码] | 按品牌语气调整 | — |
| 留言推送 | 留言发送到哪里 | radio(VIP):0邮件(默认)/ 1站点 / 2API接口 [源码] | 按实际接收方式选 | 非默认方式为 VIP 功能 |
| 选择站点 | 推送到站内的目标站点 | 仅 push_way=1 显示 [源码] | 排除当前站 | — |
| API地址 | 接收留言的 API | 仅 push_way=2 显示 [源码] | 填完整地址 | — |
| Header Key/Value | API 鉴权头 | 仅 push_way=2 显示 [源码] | 按对方要求填写 | 敏感信息 |
| 提交方式 | API 请求格式 | radio:json / formdata / query(GET) [源码] | 按对方接口要求选 | — |
| 留言字段 | 前台表单的字段 | ProTable 管理:名称/字段/类型/必填/默认值 [源码] | 类型支持 text/number/textarea/radio/checkbox/select/image/file(不含 editor/images/texts/日期等)[源码] | 字段改名影响已有数据 |
留言推送三路联动
出现条件:留言设置页始终显示 [源码]。
| 推送方式 | 显示内容 |
|---|---|
| 0 邮件 | 显示「去邮件提醒设置」链接 |
| 1 站点 | 显示站点选择下拉 |
| 2 API接口 | 显示地址、Header、提交方式配置 |
推荐值:单站用邮件即可;多站集中管理用站点推送;对接第三方系统用 API。
填错后果:API 配置错误会导致留言丢失,前台提示成功但后台收不到。
留言字段类型限制
出现条件:添加/编辑留言字段时 [源码]。
字段类型仅 8 种:text/number/textarea/radio/checkbox/select/image/file [源码],不含富文本、组图、日期等。选错会导致数据无法正确提交。
操作步骤
- 进入「功能 → 互动/留言 → 网站留言管理」。
- 查看留言详情并处理。
- 点击「网站留言设置」维护留言表单字段。
- 需要留存时点击「导出留言」。
适用场景与建议
- 留言字段决定前台表单展示哪些输入框,按实际需求增删。
- 配合「内容安全设置」启用验证码和同 IP 提交限制,防止垃圾留言。
前台调用示例
{% guestbook %}
<input type="text" name="userName" placeholder="姓名" />
<input type="text" name="cellphone" placeholder="电话" />
<textarea name="content" placeholder="留言内容"></textarea>
<button type="submit">提交</button>
{% endguestbook %}
字段名称需与后台留言设置中的调用字段一致。
注意事项
- 留言包含电话、邮箱等个人信息,导出和截图时注意隐私保护。
- 删除留言不可恢复。
- 前台表单收不到留言时,先检查模板是否使用
guestbook标签,以及验证码是否配置正确。