网站留言管理

📅 2026-11-21 👁️ 0

网站留言管理

网站留言管理用于查看和导出用户提交的留言,并维护留言表单的字段。

入口路径

后台顶部菜单 →「功能」→「互动/留言」→「网站留言管理」。实际地址:/system/plugin/interaction/guestbook,需要管理员权限(canAdmin)。

功能说明

列表展示留言时间、用户名、联系电话、Email、留言内容、IP、状态和操作;提供「导出留言」和「网站留言设置」两个入口。

界面截图

网站留言管理

截图来自演示环境,表格可能处于空数据状态;字段位置与操作入口以当前后台界面为准。

列表字段说明

字段 含义 取值或来源 对操作的影响
时间 提交时间 后台记录,只读 用于识别与筛选,不可直接编辑
用户名 留言者称呼 后台记录,只读 用于识别与筛选,不可直接编辑
联系电话 留言者电话 后台记录,只读 用于识别与筛选,不可直接编辑
Email 留言者邮箱 后台记录,只读 用于识别与筛选,不可直接编辑
留言内容 留言正文 后台记录,只读 用于识别与筛选,不可直接编辑
IP 提交 IP 后台记录,只读 用于识别与筛选,不可直接编辑
状态 未处理 / 已处理 后台记录,只读 用于识别与筛选,不可直接编辑
操作 查看详情、删除等 后台记录,只读 用于识别与筛选,不可直接编辑
取值 / 默认 怎么选 / 填写建议 影响 / 注意
:— :— :— :—
时间 提交时间 — 按业务节奏设置,参考默认值
用户名 留言者称呼 — 填便于识别的名称,与前台展示保持一致
联系电话 留言者电话 — 填真实可用的信息,格式需符合平台要求
Email 留言者邮箱 — 填真实可用的信息,格式需符合平台要求
留言内容 留言正文 — 简明描述,避免空泛
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 [源码],不含富文本、组图、日期等。选错会导致数据无法正确提交。

操作步骤

  1. 进入「功能 → 互动/留言 → 网站留言管理」。
  2. 查看留言详情并处理。
  3. 点击「网站留言设置」维护留言表单字段。
  4. 需要留存时点击「导出留言」。

适用场景与建议

  • 留言字段决定前台表单展示哪些输入框,按实际需求增删。
  • 配合「内容安全设置」启用验证码和同 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 标签,以及验证码是否配置正确。

相关文档