如何确保AnQiCMS后台设置的自定义参数能在前端模板中显示？

安企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:"未填写" }}，这样在字段为空时会显示“未填写”。