在文章详情页，如何调用并展示文章的自定义字段内容？

在安企CMS中，文章详情页面的内容展示具有很高的灵活性，尤其是对于通过内容模型自定义的字段。这些自定义字段能够帮助我们更精细化地管理和展示不同类型的信息，例如产品的价格、作者的来源、房产的户型等。那么，如何在文章详情页准确地调用并展示这些自定义字段的内容呢？本文将详细介绍这一过程。

一、自定义字段的创建与填写：奠定内容基础

在安企CMS中，自定义字段的强大之处在于其与内容模型的紧密结合。所有文章（或产品、其他自定义内容）都归属于特定的内容模型，而自定义字段正是附着在这些模型上的。

  1. 定义自定义字段： 首先，你需要登录安企CMS后台，前往内容管理 > 内容模型。在这里，你可以选择编辑现有的内容模型（如“文章模型”或“产品模型”），或者创建新的内容模型。在模型编辑界面，你会找到“内容模型自定义字段”部分，点击“添加字段”便可以开始定义。 在定义字段时，有几个关键项需要注意：

    • 参数名： 这是后台界面上显示给编辑人员看的名称，例如“文章来源”、“产品价格”。
    • 调用字段： 这是在模板中用来引用这个字段的唯一标识符，通常是英文小写字母。例如，如果参数名是“文章来源”，调用字段可以是 source；如果是“产品价格”，可以是 price。这个“调用字段”将是我们后续在模板中获取内容的核心。
    • 字段类型： 根据你想要存储的数据类型选择，如单行文本、数字、多行文本、单项选择、多项选择或下拉选择等。如果你需要字段内容支持HTML格式（例如富文本编辑器），可以选择“多行文本”类型。
    • 是否必填、默认值： 根据业务需求设定。

  2. 为文章填写自定义字段内容： 自定义字段定义完成后，当你在后台内容管理 > 发布文档（或编辑现有文章）时，在文章编辑页面的“其他参数”折叠框内，你就会看到这些为当前内容模型定义的自定义字段。在这里，你可以为每篇文章填入对应字段的实际内容。请确保你填写的内容符合字段类型要求，例如，数字类型的字段只输入数字。

二、在文章详情模板中调用自定义字段内容

安企CMS的模板系统采用类似Django的语法，变量使用双花括号 {{变量}}，逻辑判断和循环使用单花括号和百分号 {% 标签 %}。在文章详情页，我们主要通过 archiveDetail 和 archiveParams 这两个标签来调用自定义字段。

  1. 调用单个明确的自定义字段：archiveDetail 标签 当你需要直接获取某一个特定自定义字段的值时，可以使用 archiveDetail 标签，并指定其 name 参数为你在后台设置的“调用字段”。

    假设你定义了一个“文章来源”的自定义字段，其“调用字段”为 source。在文章详情页的模板（例如 archive/detail.html）中，你可以这样调用并显示它：

    <div>文章来源：{% archiveDetail with name="source" %}</div>

    如果你想将这个值赋值给一个变量以便后续处理，也可以这样做：

    {% archiveDetail articleSource with name="source" %}
<div>来源：{{ articleSource }}</div>

    这样，页面上就会显示当前文章对应的“文章来源”内容。

  2. 遍历所有自定义字段或按需展示：archiveParams 标签 archiveParams 标签提供了更灵活的方式来获取文章的所有自定义字段。它默认会返回一个排序后的数组（sorted=true），数组中的每个元素都是一个包含 Name（参数名，即后台显示的中文名）和 Value（字段值）的对象。

    如果你希望在页面上显示文章所有的自定义字段及其内容，可以使用 archiveParams 标签配合 for 循环：

    <div class="custom-fields">
    <h3>其他信息：</h3>
    {% archiveParams params %}
        {% for item in params %}
            <p><strong>{{ item.Name }}：</strong> {{ item.Value }}</p>
        {% endfor %}
    {% endarchiveParams %}
</div>

    这段代码会遍历当前文章所有自定义字段，并以“字段名称：字段值”的形式显示出来。

    有时候，你可能只关心特定的几个自定义字段，或者需要对某些字段进行特殊处理。你可以在循环内部通过 if 语句判断 item.Name 来实现：

    <div class="product-details">
    {% archiveParams productInfo with sorted=false %} {# 使用sorted=false获取map对象，可以直接通过key访问 #}
        <p><strong>产品型号：</strong> {{ productInfo.model.Value }}</p>
        <p><strong>产品颜色：</strong> {{ productInfo.color.Value }}</p>
        {% if productInfo.warranty %} {# 假设有一个名为warranty的自定义字段 #}
            <p><strong>保修期限：</strong> {{ productInfo.warranty.Value }}</p>
        {% endif %}
    {% endarchiveParams %}
</div>

    需要注意的是，当 sorted=false 时，productInfo 是一个map对象，你可以直接通过 productInfo.调用字段.Value 来访问特定字段的值，这对于明确知道要展示哪些字段时非常方便。

三、处理特殊字段类型和内容

  1. 处理包含 HTML 的多行文本字段：|safe 过滤器 如果你的自定义字段类型是“多行文本”，并且用户在后台填写了包含 HTML 标签（如加粗、链接、图片等）的内容，那么在模板中直接输出时，为了防止浏览器将其作为纯文本显示（即转义HTML标签），你需要使用 |safe 过滤器。

    {% archiveDetail productDescription with name="description" %}
<div class="product-description">
    {{ productDescription|safe }}
</div>

    |safe 过滤器告诉模板引擎，这部分内容是安全的，可以直接解析为 HTML，而不是进行转义。

  2. 处理图片（组图）自定义字段：循环显示 如果你的内容模型中包含一个“组图”类型的自定义字段（例如调用字段为 gallery），它会返回一个图片URL的数组。你需要像处理普通数组一样进行循环显示：

    {% archiveDetail imageGallery with name="gallery" %}
<div class="gallery">
    {% for imageUrl in imageGallery %}
        <img src="{{ imageUrl }}" alt="产品图片">
    {% endfor %}
</div>

通过以上方法，你可以在安企CMS的文章详情页中轻松、灵活地调用并展示各种自定义字段内容，从而打造功能更完善、信息更丰富的页面。

常见问题 (FAQ)

1. 我在模板中调用了自定义字段，但页面上什么都没有显示，是哪里出了问题？ 出现这种情况通常有几个原因：

  • 字段未创建或未填写： 请确认在后台 内容管理 > 内容模型 中，你确实为当前文章所属的模型定义了该自定义字段，并且在发布或编辑文章时，为该字段填写了内容。
  • “调用字段”名称错误： 在模板中使用的 name 参数值必须与你在后台定义自定义字段时设置的“调用字段”完全一致，包括大小写。
  • 模板标签使用错误： 检查 archiveDetail 或 archiveParams 标签的语法是否正确，例如 with 关键字是否遗漏。
  • 文章ID或Token问题： archiveDetail 标签默认获取当前页面的文章数据，如果你尝试获取其他文章的自定义字段，需要通过 id 或 token 参数明确指定文章。

2. 我的自定义字段内容是富文本编辑器编辑的，里面包含图片和文字样式，但页面上只显示了原始的HTML代码，如何才能正常显示？ 如果自定义字段的内容包含 HTML 标签，你需要在使用 {{变量}} 输出时，在变量后面加上 |safe 过滤器。例如：{{ customFieldContent|safe }}。这个过滤器会告诉模板引擎，这部分内容是安全的 HTML，应该直接渲染，而不是进行转义。

3. 我能否根据不同的文章类型（例如新闻、博客、产品），在详情页显示不同的自定义字段？ 当然可以。安企CMS的自定义字段是与“内容模型”绑定的。你可以为不同的