安企CMS模板中如何调用并展示文章的自定义参数字段？

在安企CMS中，文章的自定义参数字段是其“灵活的内容模型”这一核心功能的重要体现。它允许我们为不同类型的内容（如文章、产品）定义独有的附加属性，极大地增强了内容的表达力和网站的定制化能力。想象一下，如果你的网站需要展示产品详情，除了标题、内容、图片这些通用信息，你可能还需要“产品型号”、“颜色”、“存储容量”等具体参数。这些就是自定义参数字段发挥作用的地方。

什么是自定义参数字段？

简单来说，自定义参数字段就是文章或产品模型中预设标准字段（如标题、正文、发布时间）之外的、根据业务需求额外添加的数据项。例如，对于一篇“书籍”类的文章，你可能需要添加“作者”、“出版社”、“ISBN”等字段；对于一个“产品”模型，你可能需要“SKU”、“价格”、“库存”等字段。安企CMS允许你在后台灵活定义这些字段的名称、类型（单行文本、数字、多行文本、单选、多选、下拉选择等），并设置是否必填、默认值等。

为什么要使用自定义参数字段？

使用自定义参数字段带来的好处是显而易见的：

1. 高度定制化内容： 让你的内容不再局限于传统的少数几个字段，可以根据实际业务场景精确地构建内容结构。
2. 提升内容表达力： 能够更详尽、更准确地描述内容特点，提供用户所需的关键信息。
3. 优化用户体验： 结构化的数据更易于用户理解和筛选，例如电商网站可以根据颜色、尺寸等自定义参数进行商品筛选。
4. 利于SEO： 丰富和结构化的内容有助于搜索引擎更好地理解页面信息，提升关键词排名。

如何在安企CMS中设置自定义参数字段？

在AnQiCMS后台，自定义参数字段的设置非常直观。这主要通过“内容管理”下的“内容模型”功能实现。你可以选择修改现有模型（如文章模型、产品模型），或者新建一个内容模型。在模型编辑界面，你可以点击“内容模型自定义字段”区域的“添加字段”按钮，然后为新字段填写“参数名”（展示给编辑人员的名称）、“调用字段”（模板中调用的唯一标识，通常为英文）、“字段类型”，并根据需要设置其他属性。设置完成后，在发布或编辑该模型下的文章时，就会在“其他参数”折叠框中看到并填写这些自定义字段了。

如何在模板中调用并展示自定义参数字段？

在AnQiCMS的模板中，调用和展示文章的自定义参数字段主要依赖于其强大的模板标签系统，特别是archiveParams和archiveDetail这两个标签。

1. 使用 archiveParams 标签遍历所有自定义参数

archiveParams 标签用于获取当前文章或指定文章的所有自定义参数。它特别适合当你希望遍历并展示文章的所有额外信息时使用。

基本语法： {% archiveParams 变量名称 with id="文档ID" sorted=true %}

这里有几个关键点：

• 变量名称：你可以为获取到的自定义参数集合指定一个变量名（如params），然后在循环中通过这个变量名来访问。
• id：可选参数，如果你想获取非当前文章的自定义参数，可以通过其ID来指定。
• sorted：可选参数，默认为true。
  • 当sorted=true时，params变量将是一个有序的数组对象。每个数组元素包含Name（参数名，即后台设置的“参数名”）和Value（参数值，即文章中填写的内容）。这种方式适合用来遍历并展示所有参数。
  • 当sorted=false时，params变量将是一个无序的map对象，你可以直接通过后台设置的“调用字段”来访问，例如params.yourFieldName.Value。

示例代码（遍历所有参数，推荐方式）：

假设你的自定义字段的“调用字段”分别是 author 和 source_url，“参数名”分别是“文章作者”和“文章来源链接”，且你已在文章编辑页面填写了对应的值。

{# 假设这是文章详情页，或者通过id="某个文章ID"指定 #}
<div>
    <h3>自定义参数：</h3>
    {% archiveParams params with sorted=true %}
        {% for item in params %}
        <div>
            <span>{{item.Name}}：</span> {# 这里显示的是后台设置的“参数名” #}
            <span>{{item.Value}}</span> {# 这里显示的是文章中填写的参数值 #}
        </div>
        {% endfor %}
    {% endarchiveParams %}
</div>

这段代码会遍历文章的所有自定义参数，并以“参数名：参数值”的形式逐一展示。

示例代码（通过调用字段名直接访问，sorted=false）：

如果你明确知道要展示哪个自定义字段，并且不关心其顺序，可以使用 sorted=false 模式通过“调用字段”直接访问。

{# 假设你有一个自定义字段的“调用字段”是 `introduction`，并且参数类型是多行文本，可能包含HTML #}
<div>
    <h3>文章简介：</h3>
    {% archiveParams myCustomFields with sorted=false %}
        {# 直接通过调用字段名访问，并用|safe过滤器确保HTML内容正确解析 #}
        <span>{{myCustomFields.introduction.Value|safe}}</span>
    {% endarchiveParams %}
</div>

请注意，对于可能包含HTML内容的自定义字段（例如多行文本类型），请务必使用|safe过滤器，以确保HTML标签能够被浏览器正常解析而不是被转义显示。如果该自定义字段是Markdown格式的内容，你还可以使用|render|safe组合过滤器，让Markdown内容在前端正确渲染成HTML。

2. 使用 archiveDetail 标签直接获取特定自定义参数

archiveDetail 标签通常用于获取文章的标准字段（如标题、内容），但它也可以直接获取单个自定义参数字段的值。当你知道自定义字段的“调用字段”名称，并且只需要单独获取这一个值时，这种方法会更简洁。

基本语法： {% archiveDetail 变量名称 with name="调用字段" id="文档ID" %}

• name：这里填写你在后台设置自定义字段时的“调用字段”（通常是英文）。
• 其他参数与archiveParams类似。

示例代码：

假设你有一个自定义字段，其“调用字段”是author，“参数名”是“作者”。

{# 在文章详情页调用当前文章的作者自定义字段 #}
<div>
    文章作者：{% archiveDetail with name="author" %}
</div>

{# 如果需要指定ID的文章作者 #}
<div>
    指定文章作者：{% archiveDetail with name="author" id="123" %}
</div>

{# 如果自定义字段的值可能是HTML内容，同样需要|safe过滤器 #}
<div>
    产品特性：{% archiveDetail with name="product_features" %}{{archiveDetail with name="product_features"}|safe}}
</div>

实际应用场景举例

结合以上标签，我们可以轻松构建出复杂的内容展示页面。

例1：产品详情页显示产品参数列表

假设你为产品模型定义了自定义字段：model (型号)、color (颜色)、storage (存储)。

<div class="product-specs">
    <h3>产品参数</h3>
    {% archiveParams productParams with sorted=true %}
        {% for item in productParams %}
        <div class="spec-item">
            <span class="spec-name">{{item.Name}}：</span>
            <span class="spec-value">{{item.Value}}</span>
        </div>
        {% endfor %}
    {% endarchiveParams %}
</div>

例2：展示自定义图片组（如轮播图）

如果你的自定义字段中包含一个多图上传类型（在AnQiCMS后台，多图上传通常作为一个自定义字段类型），例如其“调用字段”为product_images：

<div class="product-gallery">
    {% archiveDetail galleryImages with name="product_images" %}
    <ul class="image-carousel">
        {% for img in galleryImages %}
        <li><img src="{{img}}" alt="产品图"></li>
        {% endfor %}
    </ul>
    {% endarchiveDetail %}
</div>

这里，archiveDetail获取到的是一个图片URL的数组，我们可以通过for循环将其逐一展示出来。

总结与注意事项

通过archiveParams和archiveDetail这两个标签，我们可以在AnQiCMS模板中灵活地调用并展示文章的自定义参数字段。关键在于理解后台设置的“调用字段”与模板标签中name参数的对应关系，以及archiveParams中sorted参数的不同用法。

在实际操作中，请