如何在AnQiCMS网站上展示留言表单，并支持自定义字段显示？
在数字化运营日益重要的今天，网站留言板不仅是用户与网站互动的重要桥梁，更是收集用户反馈、了解市场需求的关键渠道。安企CMS（AnQiCMS）深知这一需求，提供了灵活且功能强大的留言表单展示与自定义字段支持，让您能够轻松打造符合业务需求的互动平台。
第一步：配置留言表单的自定义字段
要让留言表单拥有更多个性化信息收集能力，我们需要首先在安企CMS后台进行配置。
进入安企CMS后台，找到“功能管理”菜单，选择“网站留言”。在这里，您会看到一个管理留言的功能区。安企CMS允许您为留言功能添加自定义字段，这意味着您可以根据实际业务需求，除了常规的姓名、联系方式和留言内容外，还能收集例如“服务类型”、“产品编号”、“所在行业”等特定信息。
添加自定义字段时，您可以选择不同的字段类型，以适应多样化的数据输入需求：
- 单行文本 (text)：适用于收集简短的文字信息，如姓名、公司名。
- 数字 (number)：用于收集数字类信息，如电话号码、数量等。
- 多行文本 (textarea)：适合收集较长的描述性文字，如详细的反馈内容。
- 单项选择 (radio)：提供预设选项，用户只能选择其中一项。
- 多项选择 (checkbox)：提供预设选项，用户可以多选。
- 下拉选择 (select)：以下拉菜单形式呈现预设选项，用户单选。
在配置每个自定义字段时，您可以指定其参数名（供模板调用）、字段名称（显示给用户的标签）、是否必填以及默认值或选择项。这些细致的设置确保了表单的实用性和数据收集的准确性。例如，您可以添加一个名为“service_type”的下拉选择字段，预设“售前咨询”、“技术支持”等选项，让用户快速分类他们的留言意图。
第二步：在网站页面展示留言表单
完成了后台的字段配置后，接下来我们需要将这个动态的留言表单呈现在网站的前端页面上。
安企CMS的模板机制非常灵活。根据约定，在线留言表单的模板文件通常位于/template目录下的guestbook/index.html或guestbook.html。您可以在这些文件中编写或修改表单的HTML结构和样式。
要动态显示您在后台配置的留言字段，安企CMS提供了一个非常便捷的模板标签：{% guestbook fields %}...{% endguestbook %}。这个标签会获取所有已配置的留言字段，并将其封装在一个名为fields的数组对象中，供您在模板中迭代使用。
以下是使用guestbook标签动态构建表单的基本结构：
<form method="post" action="/guestbook.html">
<!-- 动态生成字段 -->
{% guestbook fields %}
{% for item in fields %}
<div class="form-group">
<label for="{{item.FieldName}}">{{item.Name}}</label>
<div>
{% if item.Type == "text" or item.Type == "number" %}
<input type="{{item.Type}}" name="{{item.FieldName}}" id="{{item.FieldName}}"
{% if item.Required %}required{% endif %} placeholder="{{item.Content}}" class="form-control">
{% elif item.Type == "textarea" %}
<textarea name="{{item.FieldName}}" id="{{item.FieldName}}"
{% if item.Required %}required{% endif %} placeholder="{{item.Content}}" rows="5" class="form-control"></textarea>
{% elif item.Type == "radio" %}
{% for val in item.Items %}
<label>
<input type="radio" name="{{item.FieldName}}" value="{{val}}" {% if loop.first %}checked{% endif %}> {{val}}
</label>
{% endfor %}
{% elif item.Type == "checkbox" %}
{% for val in item.Items %}
<label>
<input type="checkbox" name="{{item.FieldName}}[]" value="{{val}}"> {{val}}
</label>
{% endfor %}
{% elif item.Type == "select" %}
<select name="{{item.FieldName}}" id="{{item.FieldName}}" class="form-control">
{% for val in item.Items %}
<option value="{{val}}">{{val}}</option>
{% endfor %}
</select>
{% endif %}
</div>
</div>
{% endfor %}
{% endguestbook %}
<!-- 提交按钮 -->
<div class="form-group">
<button type="submit" class="btn btn-primary">提交留言</button>
<button type="reset" class="btn btn-secondary">重置</button>
</div>
</form>
在这个例子中，for item in fields循环会遍历您在后台添加的每一个自定义字段，并根据item.Type生成相应的HTML输入元素。item.Name用于显示字段标签，item.FieldName作为输入框的name属性，item.Required则控制是否添加HTML5的required属性进行前端验证。
请注意，表单的action属性应指向/guestbook.html，这是安企CMS处理留言提交的默认接口。除了自定义字段，留言表单通常还需要以下几个标准字段才能成功提交：user_name（留言者姓名）、contact（联系方式）和content（留言内容）。这些字段即便没有在后台作为自定义字段添加，也需要在表单中包含，或者通过默认值等方式处理。
第三步：增强表单的用户体验与安全性
为了提升用户体验并确保数据安全，您还可以对留言表单做进一步的优化。
1. 集成验证码机制：
防止恶意提交和垃圾信息是留言板运营的重要一环。安企CMS内置了验证码功能。在后台开启留言评论验证码后，您需要在模板中添加验证码相关的HTML和JavaScript代码。这通常包括一个用于显示验证码图片的<img>标签，以及两个隐藏的input字段（captcha_id和captcha）和一个可见的文本输入框用于用户输入验证码。通过一段JavaScript代码，您可以实现点击图片刷新验证码的功能，增强安全性。
2. 友好的提交反馈：
用户提交留言后，给予及时的反馈至关重要。您可以在表单中添加一个隐藏字段<input type="hidden" name="return" value="html">或value="json"，告诉后台希望以何种格式返回提交结果。如果设置为html，后台会渲染一个页面显示成功或失败信息；如果设置为json，则方便您通过JavaScript在不刷新页面的情况下处理反馈，实现更流畅的用户体验。
通过上述步骤，您不仅可以在安企CMS网站上展示一个功能完善的留言表单，还能根据业务需求灵活地收集各类用户数据，并通过后台便捷地管理这些信息。
常见问题解答 (FAQ)
1. 如何管理用户提交的留言内容？
所有用户通过留言表单提交的内容都可以在安企CMS后台进行统一管理。只需登录后台，导航至“功能管理”下的“网站留言”模块。在这里，您可以查看每一条留言的详细信息，包括留言者、联系方式、留言内容以及您设置的所有自定义字段数据。此外，安企CMS通常还支持留言内容的导出功能（例如导出为CSV文件），方便您进行数据分析或归档。对于不合规或垃圾留言，也可以在此处进行删除或标记处理。
2. 如果我不想使用所有已配置的自定义字段，可以只显示一部分吗？
完全可以。您在后台配置的自定义字段是作为可选的字段集合存在的，但在前端模板中