作为一名资深的安企CMS网站运营人员，我深知内容模型的自定义字段功能对于构建丰富、个性化的网站内容有多么重要。它不仅能帮助我们灵活地组织信息，还能为用户提供更精准的筛选和展示体验。接下来，我将详细为您阐述如何在安企CMS中获取内容模型定义的自定义字段参数，并进行有效的筛选和显示。
内容模型自定义字段的创建与管理
首先，一切功能的基础都源于后台的配置。在安企CMS中，内容模型的灵活性是其核心优势之一。我们可以通过“内容管理”菜单下的“内容模型”功能，根据业务需求创建或编辑自定义内容模型，并为这些模型添加专属的自定义字段。
在添加自定义字段时，您需要设定“参数名”（这是字段在后台的显示名称）、“调用字段”（这是在模板中引用该字段时使用的唯一标识，务必使用英文字母，且记住其名称）、“字段类型”（如单行文本、数字、多行文本、单项选择、多项选择、下拉选择等）、“是否必填”以及“默认值”。特别是对于选择类型的字段，其“默认值”将定义可供选择的选项。这些精心配置的字段，将作为您前端内容展示和筛选的基础。
在模板中获取单个文档的自定义字段参数
当我们需要在文档详情页（例如，一篇产品介绍或一篇文章）中展示某个特定的自定义字段值时，安企CMS提供了简洁直观的模板标签。
您可以直接使用 {% archiveDetail with name="您的调用字段名" %} 这样的方式来获取并输出该字段的值。例如，如果您的产品模型有一个名为 product_weight 的自定义字段，其“调用字段”设置为 weight，那么在产品详情页模板中，您可以这样显示其重量：
<div>产品重量：{% archiveDetail with name="weight" %}</div>
如果您希望将这个值先赋值给一个变量再使用，可以这样操作：
{% archiveDetail productWeight with name="weight" %}{{productWeight}}</div>
这种方法适用于您明确知道要获取哪个自定义字段并直接展示其值的情况。
在模板中遍历获取所有自定义字段参数
有时，我们可能希望在一个文档详情页中，遍历并展示该文档所有已填写的自定义字段，例如显示产品的“规格参数”列表。这时，archiveParams 标签就派上用场了。
archiveParams 标签允许您获取当前文档或指定文档的所有自定义字段及其值。您可以像这样使用它：
{% archiveParams params %}
<div>
{% for item in params %}
<div>
<span>{{item.Name}}：</span>
<span>{{item.Value}}</span>
</div>
{% endfor %}
</div>
{% endarchiveParams %}
在上述代码中，params 是一个包含所有自定义字段信息的数组对象。通过循环遍历 params，item.Name 会输出您在后台设置的“参数名”（中文显示），而 item.Value 则会输出该自定义字段的具体内容。这种方式对于构建动态、灵活的参数列表非常有用。
如果您需要针对某些字段进行特殊的显示处理，或者排除某些字段不显示，可以在循环内部加入 if 逻辑判断：
{% archiveParams params %}
<div>
{% for item in params %}
{% if item.Name != '内部备注' %} {# 假设您有一个名为“内部备注”的字段不想在前台显示 #}
<div>
<span>{{item.Name}}：</span>
<span>{{item.Value}}</span>
</div>
{% endif %}
{% endfor %}
</div>
{% endarchiveParams %}
利用自定义字段进行内容筛选和显示
除了在详情页展示，自定义字段更强大的应用体现在列表页的筛选功能上，这能极大地提升用户查找内容的效率。安企CMS为此提供了 archiveFilters 和 archiveList 标签的组合使用。
archiveFilters 标签用于生成前端的筛选条件界面，例如下拉框、复选框组等。它会根据您内容模型中定义的那些允许筛选的自定义字段，自动生成对应的筛选项及其链接。
首先，在您的列表页模板中，使用 archiveFilters 来构建筛选区域：
<div>
<div>内容筛选：</div>
{% archiveFilters filters with moduleId="您的模型ID" allText="全部" %}
{% for item in filters %}
<ul>
<li>{{item.Name}}: </li>
{% for val in item.Items %}
<li class="{% if val.IsCurrent %}active{% endif %}"><a href="{{val.Link}}">{{val.Label}}</a></li>
{% endfor %}
</ul>
{% endfor %}
{% endarchiveFilters %}
</div>
在这里，moduleId 指定了您希望筛选的内容模型（例如，文章模型ID通常为1，产品模型ID通常为2）。allText 参数定义了“全部”选项的显示文本。filters 对象包含了一系列可筛选的字段（每个 item），每个字段下又包含了其所有可选的筛选值（每个 val）。val.Link 会生成带有相应筛选参数的URL，val.Label 是筛选选项的显示文本，val.IsCurrent 则判断当前选项是否被选中，方便您添加高亮样式。
当用户点击一个筛选选项时，页面URL中会带上对应的查询参数，例如 ?color=红色&size=L。
接下来，archiveList 标签将自动接收这些URL中的查询参数，并据此筛选出符合条件的文档进行展示。在 archiveFilters 区域下方，您可以像平常一样使用 archiveList 来显示文档列表：
<div>
{% archiveList archives with type="page" moduleId="您的模型ID" limit="10" %}
{% for item in archives %}
<div>
<h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
<p>{{item.Description}}</p>
{# 这里可以再次使用archiveParams或archiveDetail显示自定义字段 #}
{% archiveParams docParams with id=item.Id %}
<ul>
{% for param in docParams %}
<li>{{param.Name}}: {{param.Value}}</li>
{% endfor %}
</ul>
{% endarchiveParams %}
</div>
{% empty %}
<div>暂无符合条件的文档</div>
{% endfor %}
{% endarchiveList %}
</div>
在上述 archiveList 中，您无需手动传入筛选条件，系统会自动识别URL中的自定义字段参数并进行筛选。通过这种组合，您可以轻松实现一个功能完善的动态筛选列表。
总结
安企CMS通过其灵活的内容模型和强大的模板标签，为我们网站运营人员提供了极大的便利。从在后台定义个性化的内容字段，到在前端模板中精准地获取并展示这些字段，再到构建交互式的筛选功能，每一步都旨在帮助我们更好地管理和呈现内容，从而提升用户体验和网站的吸引力。掌握这些技巧，您就能更高效地运营您的AnQiCMS站点，满足各种复杂的业务需求。
常见问题解答
Q1: 我在内容模型中定义了自定义字段并填写了内容，但在前端模板中却无法显示，这是为什么？
首先请检查您在模板中使用的“调用字段名”是否与后台设置的完全一致，包括大小写。其次，确认您是否将文档保存或更新了，新添加或修改的字段内容需要保存后才能生效。如果字段类型是图片、文件等，也请确保路径正确。最后，检查是否清除了网站缓存，安企CMS有时会有缓存，刷新缓存能解决大部分显示问题。
Q2: 我能否同时使用多个自定义字段作为筛选条件？例如，筛选“红色”且“XL码”的产品？
是的，完全可以。当用户在前端通过 archiveFilters 生成的筛选条件进行选择时，多个选定的筛选条件会作为独立的查询参数附加到URL上（例如 /products?color=红色&size=XL）。archiveList 标签会自动解析并应用所有这些查询参数，从而实现多重条件的组合筛选。您只需要在后台内容模型中，将这些字段配置为可筛选即可。
Q3: 自定义字段是否只能在文档模型中使用，分类或单页面是否也有类似的功能？
安企CMS的灵活性体现在其设计哲学中。是的，分类和单页面也支持自定义字段。例如，您可以使用 {% categoryDetail with name="您的自定义字段" %} 来获取分类的自定义字段，或者 {% pageDetail with name="您的自定义字段" %} 来获取单页面的自定义字段。这使得您可以为不同类型的内容，都添加丰富且个性化的信息。