在安企CMS的强大功能矩阵中，内容模型和自定义字段无疑是其核心亮点之一。它赋予了网站极大的灵活性，让运营者可以根据实际业务需求，构建出文章、产品、服务、案例等各种类型的内容结构。然而，对于不熟悉模板开发的运营者来说，如何在网站前端动态、优雅地展示这些丰富多样的自定义字段，尤其是要同时显示它们的“参数名”和“实际值”，常常会成为一个挑战。

今天，作为一位资深的网站运营专家，我将带您深入剖析安企CMS模板中动态显示当前内容模型下所有自定义字段的方法，帮助您将后台的灵活配置，完美呈现在用户面前。

理解安企CMS的内容模型与自定义字段

首先，我们简要回顾一下安企CMS中自定义字段的概念。在安企CMS后台，您可以进入“内容管理”下的“内容模型”功能。在这里，您可以创建或编辑不同的内容模型（例如“文章模型”、“产品模型”）。每个内容模型都可以添加一系列“内容模型自定义字段”。

当您添加一个自定义字段时，需要定义几个关键信息：

  • 参数名（Name）： 这是在后台管理界面和前端模板中用于显示给用户或作为标签的名称，例如“文章来源”、“产品型号”。
  • 调用字段（FieldName）： 这是系统在数据库中存储和在前端模板中技术性调用该字段的唯一标识，通常是英文小写字母组合，例如source、model_number。
  • 字段类型： 决定了该字段输入数据的形式，如单行文本、多行文本、数字、单选、多选等。
  • 是否必填、默认值等： 进一步规范字段的行为。

动态显示这些字段的价值在于，无论您为内容模型添加了多少个自定义字段，或者将来如何修改它们，模板都能智能地遍历并展示，而无需每次都修改模板代码。

在模板中动态获取自定义字段的核心思路

安企CMS的模板引擎（类似Django或Blade语法）提供了强大的标签来获取和处理数据。对于动态显示自定义字段的需求，我们不再需要一个一个地去硬编码每个字段的“调用字段”名称。核心思路是利用一个特殊的标签，它能够返回当前内容（如文章、产品）下所有的自定义字段列表，然后我们再通过循环遍历这个列表，提取出每个字段的“参数名”和“实际值”。

这里，我们的主角就是 archiveParams 标签。

使用 archiveParams 标签遍历自定义字段

archiveParams 标签专为获取当前文档（或指定文档）的自定义参数而设计。它能够将后台为该文档配置的所有自定义字段，以一个可遍历的数组对象形式提供给模板。

archiveParams 标签的基本用法

通常，您会在文档详情页（例如{模型table}/detail.html）中使用这个标签。其基本结构如下：

”`twig {% archiveParams params with sorted=true %}

{% for item in params %}
    <div>
        <span>{{ item.Name }}：</span>
        <span>{{ item.Value }}</span>
    </div>
{% end