安企CMS：让自定义内容模型字段在前端焕发光彩

在使用安企CMS管理网站内容时，我们经常会遇到这样的需求：标准的内容结构已经无法完全满足特定信息的展示。比如一个产品页面，除了标题和内容，我们可能还需要展示它的“颜色选项”、“尺寸范围”或者“库存状态”等。这时，安企CMS灵活的内容模型和自定义字段功能就显得尤为重要，它允许我们根据业务的独特性来扩展内容属性。

为什么自定义字段如此重要？

安企CMS的核心优势之一就是其“灵活的内容模型”。这意味着你可以根据自己的业务需求，为不同的内容类型（例如文章、产品、活动、下载等）定义专属的数据结构。这种高度的定制性，打破了传统CMS固定字段的局限，让你的网站内容管理更贴合实际运营。

举个例子，如果你的网站是销售商品的，那么一个产品的详情页除了商品名称、描述和图片，还需要有 SKU、价格、库存量、品牌、材质、适用人群等信息。通过自定义字段，你可以将这些独特属性添加到产品模型中，让每个产品条目都拥有完整且标准化的信息。这不仅便于后台管理，也为前端页面的精细化展示提供了坚实的基础。

自定义字段的创建与类型速览

在安企CMS后台的“内容管理”下，进入“内容模型”设置，你就可以选择现有模型进行编辑，或者新增一个自定义模型。在模型编辑界面，你可以为该模型添加专属的自定义字段。

这些字段类型非常丰富，涵盖了从简单的文本输入到复杂的选择项，主要包括：

  • 单行文本： 适用于简短的文字信息，如产品型号、文章来源。
  • 数字： 只能输入数字，适合价格、库存、浏览量等。
  • 多行文本： 适合较长的文字描述，如产品特性、活动规则，支持富文本编辑器。
  • 单项选择： 提供多个选项，但只能选择其中一项，如“是否推荐”、“状态”。
  • 多项选择： 提供多个选项，允许选择多项，如产品“颜色选项”、“适用季节”。
  • 下拉选择： 形式上与单项选择类似，但在前端以下拉菜单形式呈现。

为每个字段设置好“参数名”（用于后台显示）和“调用字段”（用于前端模板调用）后，在发布或编辑文档时，你就会在“其他参数”部分看到这些自定义字段，可以根据需要填写相应的内容。

在前端页面展示自定义字段的核心方法

安企CMS采用类似Django的模板引擎语法，通过双花括号 {{变量}} 输出内容，通过 {% 标签 %} 实现逻辑控制。对于自定义字段，我们主要通过两种方式来获取并显示它们：直接引用特定字段，或者遍历所有自定义字段。

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

如果你明确知道要显示哪个自定义字段，可以直接使用 archiveDetail 标签来获取。这个标签主要用于文档详情页，它能获取当前文档的详细信息，包括所有自定义字段。你只需要指定自定义字段的“调用字段”名称即可。

假设你为产品模型添加了以下自定义字段：

  • 产品型号 (调用