AnQiCMS模板中的archiveParams标签：轻松展示文档所有自定义参数
作为一位资深的网站运营专家，我深知在内容管理系统中，如何灵活地展示和利用文档的各项属性对网站的个性化和功能扩展至关重要。AnQiCMS作为一个高效、可定制的内容管理系统，提供了丰富而强大的模板标签，其中archiveParams标签就是解锁文档自定义参数强大功能的核心工具。
本文将深入探讨archiveParams标签的使用方法，帮助您在AnQiCMS模板中游刃有余地显示当前文档，乃至其他指定文档的所有自定义参数，让您的网站内容展示更具深度和灵活性。
为什么需要自定义参数？
在AnQiCMS中，内容模型的设计极大地提升了系统的灵活性。除了标题、内容、分类等基本属性外，您还可以根据业务需求为文档（或产品等内容类型）定义各种独特的“自定义参数”。例如，一篇产品介绍可能需要“品牌”、“型号”、“颜色”、“库存”等参数；一篇房产信息可能需要“户型”、“面积”、“价格”、“装修情况”等参数。这些自定义参数在后台录入后，如何高效、准确地呈现在网站前台，便是archiveParams标签的用武之地。它架起了后台数据与前端展示之间的桥梁，让您的内容真正实现个性化。
揭秘archiveParams标签：获取文档自定义参数的核心
archiveParams标签专门用于获取当前文档或指定文档在后台配置的所有自定义参数。它的设计旨在让模板开发者能够轻松地遍历并显示这些额外的信息。
基础的使用语法如下：
{% archiveParams params with id="1" sorted=true %}...{% endarchiveParams %}
其中：
params：这是您为获取到的自定义参数集合定义的变量名。您可以根据自己的喜好将其命名为customFields、extraData等，但一旦定义，在标签内部就需使用此变量名。id：这是一个可选参数。如果您不填写id，标签将默认获取当前正在浏览的文档的自定义参数。如果您需要获取其他特定文档的参数，可以将其设置为该文档的ID，例如id="123"。sorted：这也是一个非常关键的可选参数，默认为true。- 当
sorted=true时（默认行为），params变量将是一个有序的数组对象，数组中的每个元素都是一个包含Name和Value属性的键值对。这种模式非常适合通过for循环遍历所有参数并显示。 - 当
sorted=false时，params变量将是一个无序的map对象。在这种模式下，您可以直接通过参数的“调用字段”名称来访问特定的参数，例如params.yourCustomFieldName.Value。
- 当
接下来，我们将通过具体的示例来展示这两种模式下archiveParams标签的强大功能。
在AnQiCMS模板中显示当前文档的所有自定义参数
1. 遍历并显示所有自定义参数 (推荐方式)
这是最常用且最直接的方式，适合于您希望将文档所有附加信息列表化展示的场景。由于sorted参数默认为true，我们通常可以省略它，直接用for循环来遍历。
假设您的文档（例如一个产品）在后台自定义了“品牌”、“型号”和“上市日期”等参数。在模板中，您可以这样显示它们：
<div class="custom-parameters">
<h3>产品详细参数</h3>
{% archiveParams params %}
{% for item in params %}
<div class="param-item">
<span class="param-name">{{ item.Name }}：</span>
<span class="param-value">{{ item.Value }}</span>
</div>
{% endfor %}
{% endarchiveParams %}
</div>
在这段代码中：
{% archiveParams params %}：初始化并获取当前文档的所有自定义参数，存储在params变量中。{% for item in params %}：遍历params数组，每次循环item就代表一个自定义参数。{{ item.Name }}：显示自定义参数在后台定义的“参数名”（即中文名或显示名称）。{{ item.Value }}：显示自定义参数在后台实际存储的值。
通过这种方式，无论后台为文档添加了多少个自定义参数，模板都能自动适应并将其逐一展示出来，无需修改模板代码。
2. 显示特定自定义参数 (通过参数的“调用字段”名称)
如果您只关心文档的某个特定自定义参数，或者您知道该参数的“调用字段”名称，可以使用sorted=false模式。这种模式下，params将作为一个关联数组（或Go语言中的map），您可以通过其“调用字段”名称直接访问。
假设您有一个自定义参数的“调用字段”是productPrice，它的“参数名”是“产品价格”。您可以这样获取并显示它：
<div class="product-info">
{% archiveParams data with sorted=false %}
<p>产品价格：<strong>{{ data.productPrice.Value }}</strong></p>
<p>产品库存：<span>{{ data.productStock.Value }}</span></p>
{# 如果自定义字段本身是富文本或包含HTML，记得使用 |safe 过滤器防止转义 #}
{% if data.longDescription %}
<div class="product-description">
{{ data.longDescription.Value|safe }}
</div>
{% endif %}
{% endarchiveParams %}
</div>
在这里，data变量现在是一个map，您可以通过data.productPrice.Value直接访问名为productPrice的自定义参数的值。这种方式在您需要精确控制某个特定参数的显示位置和样式时非常有用。
3. 获取其他文档的自定义参数
archiveParams标签的id属性让您能够轻松获取非当前文档的自定义参数。这在构建相关产品推荐、文章列表摘要等场景中非常实用。
假设您当前在浏览一篇文章，但希望在侧边栏显示另一个ID为100的产品文档的“型号”参数，您可以这样做：
<div class="related-product-info">
<h4>推荐产品型号</h4>
{% archiveParams relatedProduct with id="100" sorted=false %}
{% if relatedProduct.productModel %}
<p>型号：{{ relatedProduct.productModel.Value }}</p>
{% else %}
<p>未找到相关产品型号信息。</p>
{% endif %}
{% endarchiveParams %}
</div>
通过id="100"，我们指定了要获取ID为100的文档参数。
4. 跨站点调用（高级用法）
如果您在使用AnQiCMS的多站点管理功能，并且需要调用其他站点的文档自定义参数，可以使用siteId参数。例如siteId="2"将获取ID为2的站点的文档参数。不过，对于大多数展示当前站点文档参数的需求，这个参数通常不需要设置。
实用建议
- 明确定义后台参数：在AnQiCMS后台设置内容模型时，为每个自定义参数设定清晰的“参数名”（用于显示）和“调用字段”（用于模板调用），有助于您更高效地使用
archiveParams。 - 注意数据类型和安全：如果您在后台定义的自定义参数是富文本编辑器输入的内容，可能包含HTML标签。在前端显示时，请务必使用
|safe过滤器，例如{{ item.Value|safe }}，以确保HTML内容能够正确渲染，而不是被转义。同时，请确保您的内容来源是可靠的，以防XSS攻击。 - 处理空值：在使用
item.Value或data.fieldName.Value时，最好进行判断，以防某个自定义参数没有填写内容，导致页面显示空白或不美观。可以使用{% if item.Value %}或{% if data.fieldName.Value %}进行条件判断。
总结
archiveParams标签是AnQiCMS模板开发中不可或缺的利器，它提供了灵活的方式来获取和展示文档的自定义参数。无论是遍历所有参数以构建详尽信息列表，还是精准定位特定参数以突出关键信息，亦或是跨文档获取数据，archiveParams都能轻松应对。掌握其id和sorted参数的用法，将让您在AnQiCMS的内容运营和模板定制上更上一层楼，为用户提供更丰富、更个性化的网站体验。
常见问题 (FAQ)
Q1: 为什么我在模板中使用了archiveParams标签，但是没有任何内容显示出来？
A1: 这通常有几个原因。首先，请检查您是否在AnQiCMS后台的内容模型中，为该文档类型定义了自定义参数，并且在编辑文档时实际填写了这些参数的值。其次，如果您使用了sorted=false并尝试通过params.yourFieldName.Value访问，请确保yourFieldName是后台定义的“调用字段”名称，且大小写完全匹配。最后，确认您的for循环语法是否正确，以及{% endarchiveParams %}标签是否闭合