在网站运营中，留言表单是用户与网站互动、收集用户反馈或潜在客户信息的重要桥梁。一个灵活且可定制的留言表单能够极大地提升网站的实用性和用户体验。AnQiCMS（安企CMS）在这方面提供了强大的支持，允许用户在后台自定义留言表单字段，并能在前端模板中动态构建和显示这些字段，从而满足各种个性化的业务需求。

AnQiCMS 留言表单的灵活性

AnQiCMS 的核心优势之一在于其“灵活的内容模型”设计，这种灵活性也延伸到了网站留言功能中。系统不仅提供基本的留言功能，更进一步允许用户根据具体业务场景，在后台管理界面中自由添加、编辑留言表单的字段。这意味着无论您需要收集用户的联系方式、产品需求、服务反馈，还是其他任何定制化的信息，都可以通过简单的配置来实现，无需进行复杂的代码修改。这种高度的可定制性，使得AnQiCMS成为中小企业和内容运营团队进行用户互动和数据收集的理想工具。

后台配置自定义留言字段

在AnQiCMS的后台管理界面中，通常可以在“功能管理”模块下找到“网站留言管理”的相关设置。在这里，您会发现一个直观的界面，用于定义留言表单的各个字段。您可以为每个字段设定：

  • 表单名称（Name）：这是字段在前端显示给用户的名称，例如“您的姓名”、“联系电话”等。
  • 表单变量（FieldName）：这是在提交表单时，该字段在数据中对应的键名，通常建议使用英文小写字母，方便程序处理。
  • 字段类型（Type）：AnQiCMS提供了多种字段类型以适应不同数据收集需求，包括：
    • 单行文本（text）：用于收集简短的文本信息，如姓名、邮箱。
    • 数字（number）：专门用于收集数字，如年龄、数量。
    • 多行文本（textarea）：用于收集较长的文本信息，如详细描述、留言内容。
    • 单项选择（radio）：提供一组预设选项，用户只能选择其中一项。
    • 多项选择（checkbox）：提供一组预设选项，用户可以选择多项。
    • 下拉选择（select）：提供一个下拉菜单，用户从预设选项中选择一项。
  • 是否必填（Required）：可以标记某个字段为必填项，确保用户提交必要的信息。
  • 默认值或选项（Content / Items）：对于单行文本、数字、多行文本，可以设置默认提示文字（placeholder）；对于单选、多选和下拉选择，这里是定义具体选项的地方。

通过这些配置，您可以构建出高度个性化、符合业务需求的留言表单。

在模板中动态构建和显示留言表单字段

当后台的留言字段配置完成后，如何在网站前端动态显示这些字段呢？AnQiCMS提供了guestbook标签，这个标签是连接后台配置与前端展示的关键。

{% guestbook fields %}标签用于获取后台设置的所有留言表单字段信息，并将其存储在一个名为fields的数组对象中。您可以通过遍历这个fields数组，根据每个字段的类型，动态生成相应的HTML表单元素。

下面是一段典型的模板代码示例，它展示了如何遍历fields数组并生成不同的表单元素：

<form method="post" action="/guestbook.html">
{% guestbook fields %}
    {% for item in fields %}
    <div>
        <label>{{item.Name}}</label>
        <div>
            {% if item.Type == "text" or item.Type == "number" %}
            <input type="{{item.Type}}" name="{{item.FieldName}}" {% if item.Required %}required{% endif %} placeholder="{{item.Content}}" autocomplete="off">
            {% elif item.Type == "textarea" %}
            <textarea name="{{item.FieldName}}" {% if item.Required %}required{% endif %} placeholder="{{item.Content}}" rows="5"></textarea>
            {% elif item.Type == "radio" %}
            {%- for val in item.Items %}
            <input type="{{item.Type}}" name="{{item.FieldName}}" value="{{val}}" title="{{val}}"> {{val}}
            {%- endfor %}
            {% elif item.Type == "checkbox" %}
            {%- for val in item.Items %}
            <input type="{{item.Type}}" name="{{item.FieldName}}[]" value="{{val}}" title="{{val}}"> {{val}}
            {%- endfor %}
            {% elif item.Type == "select" %}
            <select name="{{item.FieldName}}">
                {%- for val in item.Items %}
                <option value="{{val}}">{{val}}</option>
                {%- endfor %}
            </select>
            {% endif %}
        </div>
    </div>
    {% endfor %}
    <div>
        <div>
            <button type="submit">提交留言</button>
            <button type="reset">重置</button>
        </div>
    </div>
{% endguestbook %}
</form>

代码解析：

  1. <form method="post" action="/guestbook.html">：这是标准的HTML表单声明，action属性指向/guestbook.html，这是AnQiCMS处理留言提交的默认接口地址。
  2. {% guestbook fields %}：调用AnQiCMS的guestbook标签，将后台配置的字段信息赋值给fields变量。
  3. {% for item in fields %}：循环遍历fields数组中的每一个字段对象。item变量代表当前正在处理的字段。
  4. {{item.Name}}：显示字段的名称，如“姓名”。
  5. {% if item.Type == "text" or item.Type == "number" %}：根据item.Type的值判断字段类型。
    • 如果是“text”或“number”，则生成一个<input>标签，type属性动态设置为item.Type，name属性设置为item.FieldName（非常重要，用于后端接收数据），placeholder设置为item.Content。{% if item.Required %}required{% endif %}则根据字段是否必填添加HTML5的required属性。
    • {% elif item.Type == "textarea" %}：生成<textarea>多行文本框。
    • {% elif item.Type == "radio" %}：循环item.Items（选项数组），为每个选项生成一个type="radio"的<input>标签。注意，所有单选按钮的name属性相同，以便实现单选效果。
    • {% elif item.Type == "checkbox" %}：同样循环item.Items，为每个选项生成一个type="checkbox"的<input>标签。多选框的name属性通常会带[]，表示可以提交多个值。
    • {% elif item.Type == "select" %}：生成<select>下拉菜单，并循环item.Items为每个选项生成<option>。
  6. item.FieldName：这个变量名与您在后台为字段设置的“表单变量”完全对应，AnQiCMS后端会通过这个name来识别并接收用户提交的数据。
  7. required：HTML5的表单验证属性，如果