在 AnQiCMS 中管理和展示内容，自定义字段扮演着至关重要的角色，它让我们的网站能够灵活地承载各种独特的信息，而不仅仅局限于标题、内容这些通用属性。无论是为产品详情页添加详细的技术参数，还是为文章补充作者简介、外部引用链接，自定义字段都能提供强大的支持。理解如何在文章详情页中调用并展示这些自定义字段，将极大地提升网站内容的丰富性和定制化程度。
AnQiCMS 的设计理念之一便是提供灵活的内容模型，这正是自定义字段得以发挥作用的基础。通过自定义内容模型，您可以根据业务需求定义各种内容类型，并为每种类型添加专属字段，以满足个性化的内容展示需求。
定义与管理自定义字段：内容模型的基石
在 AnQiCMS 后台，自定义字段的管理集中在“内容管理”模块下的“内容模型”中。系统默认提供了“文章模型”和“产品模型”，您也可以创建自己的内容模型。进入任何一个内容模型，您都可以找到“内容模型自定义字段”区域，在这里，您可以根据需要添加新的字段。
每个自定义字段都需要指定一个“参数名”（用于后台显示和识别）和一个“调用字段”（实际在模板中引用的名称）。字段类型多样，包括：
- 单行文本：适用于简短的文字描述，如作者名、产品型号。
- 数字：确保输入的内容是纯数字，例如价格、库存。
- 多行文本：适合较长的文本内容，如产品特性描述、作者履历。
- 单项选择、多项选择、下拉选择：提供预设选项供选择，适用于标准化数据，如产品颜色、尺寸。
正确地设置字段类型和调用字段名称，是后续在模板中准确调用数据的前提。
在文章详情页中调用自定义字段内容
一旦自定义字段被定义并为具体文章填写了内容，接下来就是在模板中将其展示出来。AnQiCMS 提供了两种主要的方式来调用这些自定义字段：直接调用特定字段和循环遍历所有字段。
1. 直接调用单个自定义字段
如果您知道自定义字段的“调用字段”名称，并且该字段是单个值（如单行文本、数字、多行文本），您可以直接使用 archiveDetail 标签来获取它的值。例如，如果您创建了一个名为 author 的单行文本字段：
<div>作者：{% archiveDetail with name="author" %}</div>
或者，您可以将字段值赋给一个变量，再进行后续操作，这在需要对值进行处理时非常有用：
{% archiveDetail articleAuthor with name="author" %}
<div>作者名称：{{ articleAuthor }}</div>
通过这种方式，您可以精准地将文章详情页中的自定义信息展现在指定位置。
2. 循环遍历所有自定义字段
当您希望动态展示文章所有自定义字段，或者不确定每个字段的具体名称时，archiveParams 标签会非常实用。它会获取当前文章所有的自定义字段，并将它们作为一个数组（或对象）提供给模板。
{% archiveParams params %}
<div>
{% for item in params %}
<div>
<span>{{ item.Name }}：</span>
<span>{{ item.Value }}</span>
</div>
{% endfor %}
</div>
{% endarchiveParams %}
在这段代码中，params 是一个包含所有自定义字段的数组，每个 item 都有 Name（参数名，即后台显示的中文名）和 Value（字段值）属性。这种方法特别适用于产品参数列表或动态展示额外信息。
3. 处理特定类型的自定义字段
有些自定义字段类型在展示时需要特殊处理，比如组图或多选字段。假设您定义了一个名为 arcimages 的组图字段，用于上传多张图片：
{% archiveDetail arcimages with name="arcimages" %}
<ul class="article-gallery">
{% for imgUrl in arcimages %}
<li><img src="{{ imgUrl }}" alt="文章图片" /></li>
{% endfor %}
</ul>
这里，arcimages 会返回一个图片 URL 数组，您可以通过 for 循环遍历并展示每张图片。
如果自定义字段存储的是富文本内容，其中可能包含 HTML 标签，为了避免这些标签被转义成普通文本，您需要使用 |safe 过滤器：
{% archiveDetail articleContent with name="自定义富文本字段名" %}
<div>{{ articleContent|safe }}</div>
如果自定义字段中包含 Markdown 格式的内容，并且您希望它能被解析为 HTML，则可以使用 |render 过滤器：
{% archiveDetail articleMarkdown with name="自定义Markdown字段名" %}
<div>{{ articleMarkdown|render|safe }}</div>
实践中的小技巧
- 调试利器：在开发过程中，如果对自定义字段的结构或值不确定，可以使用
|dump过滤器来打印变量的详细信息，例如{{ params|dump }}，这会显示变量的类型和内容，帮助您快速定位问题。 - 条件判断：在显示自定义字段时，最好加入条件判断，以防止字段为空时页面出现不必要的空白或错误。例如
{% if item.Value %}或{% if arcimages %}。 - 命名规范：为自定义字段选择清晰、有意义的“调用字段”名称，这将使模板代码更易于阅读和维护。
- 过滤器应用：灵活运用 AnQiCMS 提供的各种过滤器（如
|thumb用于获取缩略图、|truncatechars用于截取文本等），可以更好地美化和处理自定义字段的显示效果。
通过上述方法，您可以充分利用 AnQiCMS 的自定义字段功能，构建出功能强大、内容丰富且高度个性化的网站文章详情页，满足各种复杂的展示需求。
常见问题 (FAQ)
1. 为什么我添加了自定义字段，但在模板中调用时却没有任何内容显示？ 这通常有几个原因：
- 字段名称错误：请检查模板中
name="自定义字段名称"的部分是否与您在后台“内容模型”中设置的“调用字段”名称完全一致，包括大小写。 - 文章未保存内容：确认您在编辑文章时，是否为这个自定义字段填入了内容并成功保存。
- 字段类型不匹配：例如，如果自定义字段是多选类型，您却试图用
{% archiveDetail with name="字段名" %}直接获取单个值，可能会导致获取不到预期结果。对于多选或组图等字段，通常需要遍历其内容。
2. 如何为不同的分类文章使用不同的自定义字段？ 在 AnQiCMS 中，自定义字段是与“内容模型”而非“分类”绑定的。这意味着属于同一内容模型（例如“文章模型”）的所有文章，都将共享该模型下定义的自定义字段。如果您需要为不同分类的文章使用完全不同的自定义字段集，您可以考虑创建不同的“内容模型”，并将不同的分类关联到不同的内容模型上。例如，创建一个“新闻模型”和“教程模型”，它们可以拥有各自独立的自定义字段。
3. 我的自定义字段内容是 HTML 代码，显示时却被转义了，如何解决？
如果您的自定义字段存储了 HTML 代码（例如通过富文本编辑器输入），在模板中直接输出时，为了安全，AnQiCMS 会默认对其进行转义。为了让这些 HTML 代码能够被浏览器正常解析并显示效果，您需要在输出该字段时，使用 |safe 过滤器。例如：{{ archiveContent|safe }}。请注意，使用 |safe 意味着您信任该内容是安全的，不会带来 XSS 等安全风险。