安企CMS赋予了内容管理极高的灵活性，其中自定义参数功能更是满足个性化内容展示需求的关键。当您在后台为文章、产品或分类等内容模型设置了独有的参数后，如何将这些参数准确无误地呈现在网站前台模板中，是许多用户关心的问题。这篇文章将详细阐述这一过程，帮助您充分利用安企CMS的强大定制能力。
了解自定义参数的奥秘
首先，要确保自定义参数能在前端模板中显示，其核心在于后端内容的模型定义和数据录入。在安企CMS的后台管理界面，您需要前往“内容管理”部分，点击“内容模型”。无论是系统内置的文章模型、产品模型，还是您自行创建的自定义模型，都可以在其设置中添加“内容模型自定义字段”。
在添加自定义字段时，有几个关键信息需要您留意：“参数名”是这个字段在后台展示给您看的名称，方便管理；而“调用字段”才是真正重要的部分，它决定了在模板中访问该参数时所使用的名称，这个名称通常建议使用英文字母，且保持唯一性。此外，“字段类型”决定了参数的输入形式，例如单行文本、多行文本、数字、单项选择、多项选择或下拉选择等，这也会影响您在前端模板中获取数据后的处理方式。为这些字段设定合适的“默认值”同样重要，它可以在您未手动填写参数时提供备用内容。
举例来说，如果您为一个“文章模型”添加了一个名为“文章作者”的自定义字段，并将其“调用字段”设置为 author，那么在发布文章时，您就可以为每篇文章填写作者信息。
让参数在前端模板中绽放
一旦您在后台妥善配置了自定义参数并录入了内容，接下来就是将其呈现在网站前台了。安企CMS的模板引擎提供了简洁而强大的方式来读取这些自定义数据。
1. 直接调用单个自定义字段
如果您明确知道某个自定义字段的“调用字段”名称，并且该字段存储的是单一值（如文章作者、产品型号），那么您可以直接使用双花括号语法来调用。最常见的方式是利用 archiveDetail 标签，它专门用于获取文档的详细数据，包括其自定义参数。
例如，如果您想在文章详情页显示之前设置的 author 字段，可以这样编写模板代码：
<div>文章作者：{% archiveDetail with name="author" %}</div>
或者，如果当前页面上下文已经是文档（archive）本身，也可以直接通过对象属性访问：
<div>文章作者：{{ archive.author }}</div>
这里的 name="author" 或 archive.author 都指向您在后台内容模型中设置的“调用字段”名为 author 的参数。
2. 循环遍历所有自定义字段
有时，您可能希望在一个区域动态显示某内容项的所有自定义参数，而无需在模板中逐一列出。这时，archiveParams 标签就派上了用场。它能获取当前文档（或指定ID的文档）的所有自定义参数，并以数组形式返回，您可以遍历这个数组来展示每个参数的名称和值。
以下是遍历并显示所有自定义参数的模板代码示例：
{% archiveParams params %}
<div>
{% for item in params %}
<div>
<span>{{ item.Name }}：</span>
<span>{{ item.Value }}</span>
</div>
{% endfor %}
</div>
{% endarchiveParams %}
在这个例子中，item.Name 会显示您在后台设置的“参数名”（例如“文章作者”），而 item.Value 则显示该参数的具体内容。
3. 灵活处理复杂数据类型
自定义字段的类型多样，获取后也需要灵活处理：
多行文本或富文本编辑器内容： 如果您的自定义字段是多行文本或富文本编辑器（如Markdown编辑器）内容，其中可能包含HTML标签。为了让这些内容正确渲染而不是显示原始代码，您需要使用
|safe过滤器。如果启用了Markdown编辑器且内容是Markdown格式，您可能还需要|render过滤器先将其转换为HTML。<div>文章摘要：{{ archive.abstract|render|safe }}</div>多图上传、多选、下拉选择等： 当自定义字段类型允许选择多个值（例如图片组、多项选择）时，安企CMS通常会将其作为数组或切片返回。您需要使用
for循环来遍历这些值。例如，如果您有一个名为
product_images的自定义字段用于上传多张产品图片：{% archiveDetail productImages with name="product_images" %} <ul class="product-gallery"> {% for img in productImages %} <li><img src="{{ img }}" alt="产品图片" /></li> {% endfor %} </ul> {% endarchiveDetail %}特定字段的属性访问：
archiveParams标签也支持通过sorted=false参数以Map（键值对）的形式获取自定义字段，如果您需要精确访问某个特定字段的Name或Value，这种方式会更直接。{% archiveParams params with sorted=false %} <div>作者姓名：{{ params.author.Value }}</div> <div>联系电话：{{ params.phone_number.Value }}</div> {% endarchiveParams %}这里的
params.author.Value直接获取了调用字段为author的值。
通过以上方法，您便能将安企CMS后台设置的自定义参数灵活、准确地呈现在网站前端模板中，为您的网站内容管理带来极大的便利性和扩展性。
常见问题 (FAQ)
1. 我在后台设置了自定义参数，但在前端模板中怎么也显示不出来，可能是什么原因？
最常见的原因是“调用字段”名称在模板中输入有误，请仔细核对后台内容模型中该自定义字段的“调用字段”名称，确保大小写完全匹配。此外，也要检查您是否使用了正确的标签（例如，在文档详情页应该使用 archiveDetail 或 archiveParams），以及数据是否已经录入到该内容的自定义字段中。
2. 自定义字段中的富文本内容（如 Markdown 或 HTML）在前端显示为原始代码，而不是格式化的样式，该如何解决？
这是因为模板引擎默认会对输出的内容进行转义，以防止潜在的安全问题。如果您的自定义字段包含 HTML 或 Markdown 内容，需要在模板中调用时加上 |safe 过滤器来告诉模板引擎这是安全内容，无需转义。如果内容是 Markdown 格式且需要在前端渲染，还可能需要 |render 过滤器，如 {{ archive.my_rich_text_field|render|safe }}。
3. 如何在前端模板中判断某个自定义字段是否存在内容，或者在没有内容时显示默认占位符？
您可以使用 if 条件判断来检查字段是否存在内容。例如，{% if archive.my_custom_field %}{{ archive.my_custom_field }}{% else %}暂无内容{% endif %}。对于有默认值的字段，您也可以利用 default 过滤器，如 {{ archive.my_custom_field|default:"未填写" }}，这样在字段为空时会显示“未填写”。