安企CMS内容模型中的自定义字段如何影响文档详情页的显示？
在AnQiCMS中，内容模型与自定义字段是提升网站内容管理灵活性和展示多样性的核心功能。它们使得网站不再局限于传统的“标题+正文”模式，而是能够根据不同业务需求，展示出更具个性化和结构化的信息。那么，这些在后台精心配置的自定义字段，究竟如何影响我们网站的文档详情页的显示呢？
理解内容模型与自定义字段的关联
要探讨自定义字段如何影响文档详情页，我们首先需要理解AnQiCMS中的“内容模型”。简单来说，内容模型是您网站上各类内容的“骨架”或“蓝图”。例如，您的网站可能需要发布普通“文章”，也可能需要展示具体的“产品”信息，或者推广某个“活动”。这些不同类型的内容，其所需承载的信息结构是截然不同的。文章可能有作者、来源、发布日期；产品则需要有价格、库存、产品参数、多图展示等。
AnQiCMS的“灵活的内容模型”功能，正是为了解决这一痛点。它允许您根据实际业务需求创建或修改内容模型，并为其添加专属的“自定义字段”。这些自定义字段就像是内容模型上的一个个信息插槽，您可以根据需要定义它们。在后台“内容管理”下的“内容模型”设置中，您可以为每个模型添加自定义字段，并为其设定“参数名”（前端显示名称）、“调用字段”（模板中使用的变量名）以及“字段类型”。
字段类型非常关键，它决定了该字段能存储什么样的数据，也间接影响了前端的显示方式。AnQiCMS支持多种字段类型，如单行文本（适用于作者名、产品型号等）、数字（如价格、库存）、多行文本（如产品简介）、单项选择、多项选择、下拉选择（适用于预设选项的属性，如颜色、尺码）、以及图片和文件等。这些不同的类型，为您的内容提供了极大的结构化能力。
自定义字段在文档详情页的呈现
当您在后台“添加文档”或“编辑文档”时，一旦选择了某个内容模型下的分类，您会发现除了文档标题、内容等通用字段外，页面底部会出现一个名为“其他参数”的折叠框。这里展示的，正是您为该内容模型定义的全部自定义字段。您可以根据这些字段的提示，输入相应的内容，例如为产品填写价格、品牌，为文章添加作者、来源等。
这些在后台填入的数据，最终需要在前端的文档详情页上得以展示。AnQiCMS采用了Django模板引擎语法，让您能够灵活地控制内容的显示。在文档详情页对应的模板文件（通常是{模型table}/detail.html或自定义的文档模板）中，您有多种方式来调用这些自定义字段：
直接通过变量名调用： 对于简单、确定的自定义字段，例如您定义了一个调用字段为
author的单行文本字段，可以直接在模板中使用{{archive.author}}来显示其内容。这种方式简洁明了，适用于您明确知道字段名称且字段内容不需要特殊处理的情况。使用
archiveDetail标签获取：archiveDetail是AnQiCMS提供的强大标签，它不仅能获取文档的内置字段，也能按名称获取自定义字段。例如，如果您的产品模型有一个调用字段为price的数字字段，您可以使用{% archiveDetail with name="price" %}来获取并显示价格。这种方法尤其适用于您想在模板中单独获取某个自定义字段值，并可能对其进行额外处理的场景。使用
archiveParams标签循环获取所有自定义字段： 在某些情况下，您可能希望将某个文档的所有自定义字段动态地列出来，例如在产品详情页展示一个完整的“产品参数”列表。这时，archiveParams标签就非常方便了。它会返回一个包含所有自定义字段的数组对象，您可以通过for循环遍历这个数组，显示每个字段的名称和值：{% archiveParams params %} {% for item in params %} <div> <span>{{item.Name}}：</span> <span>{{item.Value}}</span> </div> {% endfor %} {% endarchiveParams %}这种方式非常灵活，即便您后续在后台增删了自定义字段，前端页面也能自动适应，无需修改模板代码。
不同自定义字段类型的显示考量
不同类型的自定义字段，在前端展示时可能需要不同的处理方式：
- 单行文本、数字、单选/下拉选择： 这类字段的内容通常是纯文本或数字，可以直接通过
{{变量名}}输出。 - 多行文本或富文本（例如开启Markdown编辑器后）： 这些字段可能包含HTML标签或Markdown语法。为了确保这些内容能够被浏览器正确解析和渲染，而不是作为纯文本显示，您需要使用
|safe过滤器。如果您的多行文本字段存储的是Markdown格式的内容，并且您希望它在前端自动转换为HTML，除了后台开启Markdown编辑器外，还需要在模板中使用|render|safe过滤器，如{{archive.introduction|render|safe}}。 - 图片/组图字段： 如果您自定义了一个用于上传单张图片的字段，其值将是图片的URL。您可以在模板中直接使用
<img>标签引用：<img src="{{archive.custom_image_field}}" alt="描述" />。如果自定义字段允许上传多张图片（组图），那么该字段的值通常是一个图片URL数组，您需要使用for循环来遍历并显示每张图片。
通过实际案例理解显示效果
想象一下，您正在构建一个产品展示网站，产品详情页需要显示产品的“品牌”、“型号”、“功率”、“适用面积”等详细参数。通过AnQiCMS的内容模型，您可以为“产品模型”添加这些自定义字段，类型可能是单行文本、数字或下拉选择。
当用户访问某个产品详情页时，模板会这样组织内容：
首先，用<h1>{{archive.Title}}</h1>显示产品名称。
接着，通过archiveDetail获取产品大图：<img src="{% archiveDetail with name='Logo' %}" alt="{% archiveDetail with name='Title' %}" />。
然后，最精彩的部分来了——产品参数列表。您可以使用archiveParams标签，遍历并显示所有自定义参数：
<div>
<h3>产品参数：</h3>
{% archiveParams params %}
{% for item in params %}
<div>
<span>{{item.Name}}：</span>
<span>{{item.Value}}</span>
</div>
{% endfor %}
{% endarchiveParams %}
</div>
这样一来，无论您在后台为产品添加了多少参数，前端页面都能自动、优雅地展示出来，无需每次都修改模板代码。如果产品简介是一个富文本字段，您会使用<div>{% archiveDetail with name="Description" %}{{archive.Description|safe}}</div>来确保其HTML内容被正确解析。
通过上述方式，AnQiCMS的自定义字段极大地提升了内容的丰富度和管理效率，让您可以轻松构建出结构清晰、信息完善且高度个性化的文档详情页。它赋予了内容运营者对信息展示强大的掌控力，让您的网站内容不再千篇一律。
常见问题 (FAQ)
Q1：我定义了一个多行文本的自定义字段，为什么在详情页显示出来是带HTML标签的纯文本？
A1：这是因为Django模板引擎默认会对输出内容进行HTML转义，以防止XSS攻击。如果您的多行文本字段内容是富文本编辑器编辑的HTML代码，或者您希望Markdown内容转换为HTML显示，需要在模板中调用该字段时使用|safe过滤器，例如{{archive.your_custom_field|safe}}。如果内容是Markdown格式，则需要使用|render|safe，例如{{archive.your_markdown_field|render|safe}}。
Q2：我创建了一个自定义的“产品图集”字段（多图上传），应该如何在详情页显示多张图片？ A2：当自定义字段设置为