与网站访客保持互动，收集用户反馈，是每个网站运营者都非常重视的环节。无论是解答疑问、收集建议，还是提供客户服务，一个高效便捷的留言系统都能极大地提升用户体验和运营效率。AnQiCMS 深知这一点，为我们提供了简洁高效的访客留言功能，让从表单展示到结果管理的全过程变得轻松自如。
轻松构建访客留言表单
要在网站前端展示访客留言表单，AnQiCMS 采用了灵活的模板标签方式。通常，我们会创建一个名为 guestbook/index.html 的模板文件来承载留言功能，但也可以根据自己的设计偏好，在任何需要显示留言表单的页面中调用。
在模板中，核心是 {% guestbook fields %}...{% endguestbook %} 这个标签。它会动态地获取我们在后台配置的所有留言字段，并将它们作为一个 fields 数组传递给我们。这意味着，无需修改代码，只要在后台调整字段，前台表单就会自动更新。
AnQiCMS 巧妙地将每个留言字段作为 fields 数组中的一个 item 对象来处理。每个 item 都包含了表单所需的各种信息，比如：
item.Name：字段的显示名称，比如“您的姓名”、“联系方式”。item.FieldName：字段在后台和提交时对应的变量名，如user_name、contact。item.Type：字段的输入类型，可以是text（单行文本）、number（数字）、textarea（多行文本）、radio（单项选择）、checkbox（多项选择）或select（下拉选择）。item.Required：一个布尔值，表示该字段是否为必填项。item.Content：字段的默认提示文本（placeholder）。item.Items：如果字段类型是radio、checkbox或select，这个数组会包含所有的可选项。
我们可以通过一个简单的 for 循环遍历 fields 数组，根据 item.Type 动态生成不同类型的输入框。例如，对于 text 或 number 类型的字段，可以生成 <input type="{{item.Type}}" name="{{item.FieldName}}" ...>；对于 textarea 则生成 <textarea name="{{item.FieldName}}" ...>；而对于选择类型，我们则可以进一步循环 item.Items 来生成具体的选项。
表单提交非常直接，只需将 form 标签的 action 属性指向 /guestbook.html 即可。除了 user_name（留言用户名）、contact（联系方式）、content（留言内容）这几个核心字段外，所有我们在后台自定义的字段也会一同提交。如果希望提交后能获取 JSON 格式的返回结果而非默认的 HTML，可以在表单中添加一个隐藏字段 <input type="hidden" name="return" value="json">。
为了防止垃圾信息和恶意提交，建议在留言表单中集成验证码。AnQiCMS 提供了便捷的验证码功能。您只需在后台开启相关设置，并在模板中添加一个 captcha 字段、一个隐藏的 captcha_id 字段以及一个用于显示验证码图片的 img 标签，配合简单的 JavaScript 代码调用 /api/captcha 接口，就能实现动态加载和刷新验证码，有效提升表单安全性。
灵活配置留言字段
留言表单的强大之处在于其高度的可定制性。AnQiCMS 允许我们根据具体的业务需求，在后台灵活地配置留言字段。
进入后台的“功能管理”菜单，您会找到“网站留言管理”选项。在这里，您可以轻松地添加、编辑或删除表单字段。无论您是需要收集客户的电话、邮箱、公司名称，还是需要提供一个关于产品偏好的多选选项，都能在这里自定义。您可以为每个字段定义清晰的名称，选择合适的输入类型（单行文本、数字、多行文本、单选、多选、下拉选择），并设置是否为必填项，甚至为选择类型的字段预设选项值。这种灵活性确保了留言表单能够完美适应各种信息收集场景，无需任何代码修改。
高效管理访客留言结果
当访客提交留言后，所有信息都会集中呈现在后台的“功能管理” -> “网站留言管理”区域。这里提供了一个直观的列表，方便我们快速浏览和管理所有留言。
在留言管理界面，我们可以方便地查看每条留言的详细内容，包括提交者的用户名、联系方式、留言时间，以及所有自定义字段的信息。对于不再需要或确认是垃圾信息的留言，可以进行删除操作。AnQiCMS 还支持留言内容的导出，这对于数据分析或存档备份来说非常实用。
值得一提的是，AnQiCMS 还支持留言邮件提醒功能。在后台配置好邮件服务器信息后，一旦有新的留言提交，系统就会自动发送邮件通知，确保我们不会错过任何重要的用户反馈或潜在的商机，能够及时响应客户需求。
从前端友好的表单展示，到后台灵活的字段配置，再到便捷的留言管理，AnQiCMS 都提供了一站式解决方案。它不仅简化了网站留言功能的开发和维护，更通过其强大的自定义和管理能力，帮助我们更有效地与访客互动，收集宝贵信息，从而推动网站的持续发展和优化。
常见问题 (FAQ)
1. 留言表单的样式和自定义字段在哪里配置？
留言表单的结构和自定义字段是在 AnQiCMS 后台的“功能管理” -> “网站留言管理”中进行配置的。您可以在那里添加、编辑字段，设置它们的类型、名称、是否必填等。至于表单的视觉样式，则需要通过修改前端模板文件（如 guestbook/index.html）中的 CSS 来实现。
2. 如何开启留言邮件提醒功能，确保不会错过访客留言？ AnQiCMS 支持留言邮件提醒。您需要在后台的“功能管理” -> “邮件提醒管理”中配置好 SMTP 邮件服务器的相关信息，包括发件人邮箱、密码、SMTP 服务器地址和端口等。配置完成后，一旦有新的留言提交，系统就会自动发送邮件通知到您指定的接收邮箱。
3. 留言表单可以添加验证码吗？有什么作用？ 是的，留言表单可以添加验证码。在 AnQiCMS 后台开启验证码功能后，需要在前端留言模板中添加相应的验证码显示和输入字段。验证码的主要作用是防止自动化程序（如垃圾评论机器人）进行恶意提交或发送大量垃圾信息，从而保护网站内容环境的整洁和数据安全。