作为一位资深的网站运营专家，我深知一套灵活的内容管理系统对于高效运营的重要性。安企CMS（AnQiCMS）凭借其强大的自定义内容模型功能，为我们应对多变的内容展示需求提供了坚实的基础。然而，仅仅在后台定义好这些字段还不够，如何将这些精心设置的自定义数据准确、优雅地呈现在网站前台，才是模板制作中的核心挑战。今天，我们就来深入探讨一下，在制作安企CMS模板时，如何获取并展示内容模型中新增的自定义字段数据。
安企CMS之所以能广受中小企业和内容运营团队的青睐，其“灵活的内容模型”功不可没。它允许我们根据业务需求，不仅限于传统的文章标题、内容等，还能自定义诸如“产品价格”、“作者来源”、“视频时长”、“商品SKU”甚至是“多图轮播”等个性化字段。这些自定义字段极大地丰富了内容的维度，让我们的网站能够承载更多元化的信息展示。它们可以是简单的文本、数字，也可以是多行文本、单选、多选或下拉选择，甚至支持上传文件或图片组。
要将这些自定义字段的数据呈现在网站前台，我们首先需要理解安企CMS的模板机制。安企CMS采用了类似Django模板引擎的语法，这种语法对于熟悉各类前端框架的开发者而言，上手非常容易。在模板中，我们通过双花括号 {{变量}} 来输出数据，而条件判断、循环控制等逻辑操作则使用 {% 标签 %} 这样的形式。变量通常采用驼峰命名法则，例如 {{archive.Title}} 用于获取文档标题。掌握了这些基本语法，获取自定义字段数据就水到渠成了。
在安企CMS的模板体系中，获取内容模型中的自定义字段数据主要有两种核心方法：通过 archiveDetail 标签直接获取单个字段，以及通过 archiveParams 标签遍历所有字段。
方法一：通过 archiveDetail 标签精准获取单个自定义字段
当你清楚地知道某个自定义字段的“调用字段名”（即在后台内容模型中定义的英文字段名，如 author、productPrice、videoUrl 等）时，使用 archiveDetail 标签是最直接、最简洁的方式。这个标签通常用于文档详情页，它能够获取当前文档或指定ID文档的详细信息。
你可以这样使用它：
{# 如果自定义字段的调用字段名是 'author' #}
<div>作者：{% archiveDetail with name="author" %}</div>
{# 如果自定义字段是产品价格，调用字段名是 'productPrice' #}
<div>产品价格：¥ {% archiveDetail with name="productPrice" %}</div>
{# 还可以通过设置变量名来进一步处理数据 #}
{% archiveDetail videoLink with name="videoUrl" %}
<a href="{{ videoLink }}" target="_blank">观看视频</a>
这种方法简单高效，尤其适合于那些你明确知道其调用字段名且需要单独展示的自定义数据。
方法二：通过 archiveParams 标签灵活遍历所有自定义字段
当你的内容模型中有多个自定义字段，或者你不确定具体有哪些字段，但希望动态地展示它们时，archiveParams 标签就显得非常强大和灵活了。它允许你获取当前文档或指定文档的所有自定义参数，并进行遍历展示。
archiveParams 标签的典型用法如下：
{% archiveParams params %}
{% for item in params %}
<div>
{# item.Name 是自定义字段在后台设置的中文名称，item.Value 是该字段的值 #}
<span>{{ item.Name }}：</span>
<span>{{ item.Value }}</span>
</div>
{% endfor %}
{% endarchiveParams %}
这里，{% archiveParams params %} 会将当前文档的所有自定义字段包装成一个名为 params 的数组对象。数组中的每个元素又是一个对象，包含了 Name（字段的显示名称）和 Value（字段的具体数据）。通过 for 循环，我们就能动态地列出所有自定义字段及其值。
你还可以通过 id 参数来指定获取某个特定文档的自定义字段，例如：
{% archiveParams params with id="123" %}
{# 遍历文档ID为123的自定义字段 #}
...
{% endarchiveParams %}
默认情况下，archiveParams 会按照你在后台设置的排序顺序返回字段，这是因为 sorted=true 是其默认行为。
有时，你可能不希望展示所有自定义字段，比如某些内部使用的字段。这时，你可以在循环中使用 if 逻辑进行筛选：
{% archiveParams params %}
{% for item in params %}
{# 排除名为“内部备注”和“管理员可见”的字段 #}
{% if item.Name != '内部备注' and item.Name != '管理员可见' %}
<div>
<span>{{ item.Name }}：</span>
<span>{{ item.Value }}</span>
</div>
{% endif %}
{% endfor %}
{% endarchiveParams %}
在列表页（archiveList）中展示自定义字段
除了在详情页展示，我们经常需要在内容列表页（如文章列表、产品列表）中，为每个列表项显示其自定义字段的简要信息。archiveList 标签获取的数据集中，每个 item 对象也包含了对应的自定义字段。
直接调用方式与 archiveDetail 类似：
{% archiveList archives with type="page" limit="10" %}
{% for item in archives %}
<h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
{# 如果每个文章都有一个自定义字段 'summaryImage' 作为缩略图 #}
{% if item.summaryImage %}
<img src="{{ item.summaryImage }}" alt="{{ item.Title }}">
{% endif %}
<p>作者：{{ item.author }}</p> {# 假设自定义字段名为 'author' #}
<p>{{ item.Description }}</p>
{% endfor %}
{% endarchiveList %}
请注意，这里的 item.author 和 item.summaryImage 假设是直接通过“调用字段”获取的。如果自定义字段的值是复杂的结构，比如图片组，则需要在 archiveDetail 或 archiveParams 中进一步处理。
例如，如果你的自定义字段 productImages 是一个图片组：
{% archiveDetail currentProduct with name="Id" %} {# 获取当前文档的ID #}
{% archiveParams params with id=currentProduct %}
{% for item in params %}
{% if item.Name == '产品图片集' %} {# 假设你的图片组字段名为“产品图片集” #}
<div class="product-gallery">
{% for imgUrl in item.Value %} {# item.Value 此时是一个图片URL数组 #}
<img src="{{ imgUrl }}" alt="产品图片">
{% endfor %}
</div>
{% endif %}
{% endfor %}
{% endarchiveParams %}
总结与**实践
安企CMS的自定义内容模型与模板标签的结合，为我们构建个性化、功能丰富的网站提供了极大的便利。无论是通过 archiveDetail 标签精准获取单个自定义字段，还是利用 archiveParams 标签灵活遍历所有字段，都能够满足不同场景下的数据展示需求。
在实际操作中，我建议您：
- 明确字段的“调用字段”：在后台定义自定义字段时，为其设置一个清晰、唯一的英文调用字段名，这是模板中精准获取数据的基础。
- 善用
archiveParams调试：在开发初期，当你不确定有哪些自定义字段或其结构时，先用archiveParams遍历所有字段并输出，可以帮助你更好地理解数据结构。 - 注意字段类型：图片组等复杂类型需要额外的
for循环来展示。多选字段的值可能是一个字符串，需要根据具体需求进行解析或直接显示。 - 查阅官方文档：安企CMS的模板标签文档（如
tag-archiveDetail.md、tag-archiveParams.md和tag-archiveList.md）是你的**参考手册，它们提供了详尽的参数说明和示例。
通过这些方法，你将能够游刃有余地驾驭安企CMS的自定义字段，为你的网站带来更丰富、更具吸引力的内容展示。
常见问题 (FAQ)
Q1: 为什么我添加的自定义字段在模板中无法直接通过 {{archive.自定义字段名}} 获取到？
A1: 安企CMS的模板引擎对变量名有特定的解析规则。自定义字段的“调用字段”名称在模板中默认是以驼峰命名的形式直接作为 archive 对象或 item 对象的属性来访问的。如果你在后台设置的调用字段名是 my_custom_field，尝试在模板中使用 {{archive.MyCustomField}} 或 {{item.MyCustomField}}。如果仍无法获取，请检查字段名称是否拼写正确，或者尝试使用 archiveParams 标签来遍历查看所有可用的自定义字段及其对应的 Name 和 Value。
Q2: 我的自定义字段是图片类型（单图或多图），如何在模板中正确显示图片？
A2: 如果是单图上传的自定义字段，假设调用字段名为 myImage，你可以直接通过 {% archiveDetail with name="myImage" %} 或 {{item.MyImage}} 获取图片URL，然后放入 <img> 标签的 src 属性中：<img src="{% archiveDetail with name="myImage" %}" alt="...">。如果是多图上传（图片组），这个字段的值会是一个图片URL数组。你需要使用 archiveParams 标签获取该字段，然后在其 Value 上使用 for 循环遍历每一个图片URL：
{% archiveParams params %}
{% for field in params %}
{% if field.Name == '我的图片组字段名' %} {# 这里的“我的图片组字段名”是你在后台设置的自定义字段显示名称 #}
{% for imageUrl in field.Value %}
<img src="{{ imageUrl }}" alt="图片描述">
{% endfor %}
{% endif %}
{% endfor %}
{% endarchiveParams %}
Q3: 我想在内容列表页（如文章列表）中显示每个文章的自定义字段，应该如何操作？
A3: 在内容列表页使用 archiveList 标签时，通过 for 循环遍历得到的每个 item 对象，都会包含该文章的所有基本字段和自定义字段。你可以直接尝试通过 {{item.你的自定义字段调用名}} 来访问。例如，如果你有一个名为 customExcerpt 的自定义字段作为文章摘要，可以直接在列表中使用 {{item.CustomExcerpt}}。如果自定义字段是复杂类型或你不确定其调用名，也可以在 archiveList 的 for 循环内部，再次使用 archiveParams 标签来获取当前 item 的所有自定义字段，通过 {% archiveParams currentItemParams with id=item.Id %}