如何在AnQiCMS文档详情页显示自定义字段的内容？

在AnQiCMS中管理网站内容时，我们经常会遇到需要为不同类型的文档（例如文章、产品等）添加一些独特信息的需求。安企CMS提供了灵活的内容模型功能，允许我们自定义字段来满足这些个性化需求。那么，当这些自定义字段被创建并填充数据后，如何在网站的文档详情页面中将它们展示出来呢？

这实际上比您想象的要简单，AnQiCMS强大的模板标签系统为我们提供了多种便捷的方式来实现这一点。

第一步：回顾自定义字段的创建

在我们开始在详情页显示自定义字段之前，我们首先要确保这些字段已经在AnQiCMS后台的内容模型中正确创建。通常，我们会进入后台的“内容管理” -> “内容模型”部分。在这里，您可以选择编辑现有的内容模型（如“文章模型”或“产品模型”），或者创建一个全新的模型。

在内容模型的编辑界面，有一个“内容模型自定义字段”区域。在这里，我们添加每一个自定义字段时，需要填写“参数名”（这是字段的中文显示名称，方便后台管理和理解）和“调用字段”（这是在模板中实际使用的字段名称，通常是英文）。理解这个“调用字段”对于后续在模板中获取数据至关重要。例如，如果您为产品模型添加了一个名为“产品特点”的字段，其“调用字段”设置为product_features，那么在模板中，我们就需要使用product_features来获取其内容。

第二步：找到文档详情页对应的模板文件

要在文档详情页显示自定义字段，我们需要修改对应模型下的详情页模板。AnQiCMS的模板文件通常存放在/template目录下，并按照模板包名称和模型类型进行组织。

例如，一个文章模型的详情页模板文件可能位于/{你的模板目录}/article/detail.html或者/{你的模板目录}/article_detail.html（具体取决于您的模板组织模式）。如果您不确定，可以参考AnQiCMS文档中“模板制作”->“目录和模板”一节来确认。

第三步：在模板中显示自定义字段的内容

找到正确的模板文件后，我们就可以开始添加代码来显示自定义字段了。AnQiCMS提供了两种主要的方式来获取并展示自定义字段的内容：直接调用特定字段和循环显示所有自定义字段。

1. 直接调用单个自定义字段

如果您明确知道某个自定义字段的“调用字段”名称，并且只想在页面的特定位置显示它，那么可以使用archiveDetail标签的name参数直接指定。

假设我们为“文章模型”添加了一个自定义字段，其“调用字段”为source_author（表示文章的来源作者）。在文档详情页的模板中，我们可以这样显示它：

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

或者，如果您已经通过archiveDetail archive这样的方式将当前文档的全部信息赋给了一个变量archive，那么也可以直接通过点语法访问：

<div>文章来源作者：{{ archive.source_author }}</div>

这种方法简洁明了，适用于您只想显示少数几个已知自定义字段的场景。

2. 循环显示所有自定义字段

有时候，我们可能不确定一个文档模型到底有哪些自定义字段，或者希望动态地列出所有的附加信息。这时，archiveParams标签就派上用场了。它允许我们获取当前文档所有自定义字段的列表，然后通过循环来展示。

这个标签通常会返回一个包含每个自定义字段名称（Name）和值（Value）的对象数组。

以下是在模板中循环显示所有自定义字段的示例代码：

{% archiveParams params %}
<div class="custom-fields">
    {% for item in params %}
    <div class="custom-field-item">
        <span class="field-name">{{ item.Name }}：</span>
        <span class="field-value">{{ item.Value }}</span>
    </div>
    {% endfor %}
</div>
{% endarchiveParams %}

在上面的代码中：

• {% archiveParams params %} 将当前文档的所有自定义参数获取并存储在params变量中。
• {% for item in params %} 遍历params数组中的每一个自定义字段。
• {{ item.Name }} 显示该自定义字段在后台设置的“参数名”。
• {{ item.Value }} 显示该自定义字段具体填写的内容。

这种方式非常灵活，特别是当您的内容模型有大量自定义字段，或您希望在不同的文档模型之间复用相同的显示逻辑时。

3. 处理特定类型的自定义字段

值得注意的是，自定义字段的类型会影响其在前端的显示方式：

• 普通文本字段： 大多数文本、数字字段可以直接{{ item.Value }}或{{ archive.your_field }}显示。
• 富文本或Markdown字段： 如果您的自定义字段允许输入HTML或Markdown内容（例如，一个复杂的“产品详情”字段），直接输出可能会导致HTML标签被转义。为了让浏览器正确解析并渲染这些内容，您需要使用|safe过滤器，如果启用了Markdown编辑器，可能还需要|render过滤器。

  
  {# 如果是HTML内容 #}
  <div>自定义富文本内容：{{ archive.rich_text_field|safe }}</div>
  {# 如果是Markdown内容 #}
  <div>自定义Markdown内容：{{ archive.markdown_field|render|safe }}</div>
  

• 图片字段： 如果自定义字段是图片类型，其Value通常是图片的URL。您可以像处理普通图片一样，将其作为<img>标签的src属性来显示。

  
  {# 假设自定义字段 'product_image' 存储图片URL #}
  <img src="{{ archive.product_image }}" alt="产品图片" />
  

通过以上方法，您就可以轻松地在AnQiCMS的文档详情页中展示各种自定义字段的内容了。这使得您的网站内容展示更加丰富和个性化，充分发挥了AnQiCMS灵活内容模型的优势。

常见问题 (FAQ)

Q1: 我在后台创建了自定义字段并填充了内容，但在文档详情页中却看不到任何显示，是哪里出了问题？ A1: 首先，请检查您是否已在对应的文档详情页模板中添加了用于显示自定义字段的代码，并且确保“调用字段”名称与模板中使用的name参数或变量名完全一致（区分大小写）。其次，检查您的模板文件是否被AnQiCMS正确加载。如果模板文件修改后效果未更新，可能需要清除系统缓存或刷新浏览器缓存。

Q2: 如果我的自定义字段是图片类型，如何在前端显示这张图片？ A2: 当自定义字段是图片类型时，其值通常是图片的URL地址。您可以在模板中使用<img>标签，将这个字段的值作为src属性。例如，如果您的图片自定义字段的调用字段是product_photo，您可以这样显示它：<img src="{{ archive.product_photo }}" alt="图片描述" />。

Q3: 我的自定义字段是富文本或Markdown格式的，内容包含HTML标签或Markdown语法，为什么在页面上只显示了原始文本，标签都被转义了？ A3: AnQiCMS模板引擎为了安全，默认会对所有输出内容进行HTML转义，以防止XSS攻击。如果您的自定义字段内容本身就是HTML或Markdown，您需要在输出时使用|safe过滤器来告诉模板引擎这段内容是安全的，不需要转义。如果内容是Markdown，并且希望渲染成HTML，还需要在|safe之前加上|render过滤器，例如：{{ archive.rich_text_content|safe }} 或 {{ archive.markdown_content|render|safe }}。