在构建和运营网站时，我们常常需要展示除了标题和正文之外的更多信息，例如产品的型号、颜色、库存，或是文章的作者、来源、发布平台等。AnQiCMS深知这种个性化内容展示的重要性，因此提供了高度灵活的自定义参数字段功能，让网站内容管理和前端展示变得既强大又便捷。接下来，我们就一起深入了解如何在AnQiCMS中，充分利用这一功能，让你的网站内容动态起来。

第一步：定义你的内容结构——自定义参数字段的创建

在AnQiCMS中，所有内容都基于“内容模型”来组织。无论是文章、产品还是其他自定义类型，你都可以为其量身定制一套独特的字段结构。这就像为你的内容搭建一个专属的“骨架”，确保每种内容类型都能承载其特有的信息。

要创建或修改自定义参数字段，你需要前往AnQiCMS后台的“内容管理”部分，找到“内容模型”。这里默认提供了“文章模型”和“产品模型”，你也可以根据业务需求新增自定义模型。

选择一个内容模型进入编辑界面，你会看到一个名为“内容模型自定义字段”的区域。在这里，你可以点击“添加字段”，为该模型添加新的自定义参数。在添加过程中，有几个关键信息需要明确：

  • 参数名： 这是这个自定义字段在后台管理界面显示给管理员看的名称，例如“产品型号”、“作者名称”、“库存数量”。它应该是直观易懂的中文描述。
  • 调用字段： 这是在前端模板中调用这个参数时会用到的字段名，必须是英文字母，且建议使用驼峰命名法（如productModel、authorName、stockQuantity）。在后续的模板开发中，我们将主要通过这个“调用字段”来获取数据。
  • 字段类型： AnQiCMS支持多种字段类型，以适应不同数据的录入需求，例如：
    • 单行文本： 适用于简短的文字信息，如型号、品牌。
    • 数字： 确保只能输入数字，适用于价格、库存等。
    • 多行文本： 适用于较长的描述，如产品特点、作者简介。
    • 单项选择、多项选择、下拉选择： 这些选择型字段非常适合预设选项，如颜色（红、蓝、绿）、尺码（S、M、L）、地区等，大大提高了数据录入的标准化和准确性。你可以在“默认值”中一行一个地设置这些选项。
  • 是否必填： 根据字段的重要性，你可以选择它是否为发布内容时的必填项。
  • 默认值： 为字段设置一个默认值，可以在内容发布时自动填充，减少人工输入。

完成这些设置后，保存你的内容模型。现在，你已经成功地为你的内容类型定义了全新的数据结构。

第二步：填充你的数据——为文章或产品添加自定义信息

有了自定义的字段结构，接下来就是为实际的文章或产品录入这些数据。当你前往“内容管理”下的“发布文档”或编辑现有文档时，你会发现页面底部有一个“其他参数”的折叠框。

展开这个折叠框，你就会看到刚刚在内容模型中定义的那些自定义字段，按照你设定的“参数名”清晰地排列着。你可以轻松地为每一篇内容填入独特的属性值，无论是输入文本、选择数字，还是在下拉菜单中进行选择，都非常直观。

如果某些字段留空，而你在内容模型中为它设置了默认值，那么在前端显示时，系统会自动将默认值赋值给该字段。对于文章内容中包含的图片或自动提取简介等功能，AnQiCMS也会智能地进行处理，帮助你节省时间。

第三步：动态展示内容——在前端模板中调用自定义参数

数据录入完毕，最激动人心的部分莫过于如何在网站前端将这些自定义信息动态地展示出来。AnQiCMS采用Django模板引擎语法，其简洁强大的标签和变量调用方式，让这一过程变得高效而灵活。

在模板中显示自定义参数，主要有以下几种常见方法：

1. 在详情页中直接调用特定自定义字段

如果你在文章或产品详情页（通常是detail.html或{模型table}/detail.html）中，想要显示某个特定的自定义参数，比如文章的“作者”或产品的“型号”，可以直接通过archive对象访问其属性：

”`twig {# 假设你的自定义字段“调用字段”是 author #}