AnQiCMS 提供了一个灵活且强大的内容模型功能，让网站管理者能够根据自身业务的独特需求，创建和管理多样化的内容类型。这不仅仅是简单地发布文章或产品，而是为每一种内容构建一个专属的“蓝图”，确保信息的结构化、标准化，从而更好地进行展示和管理。

为什么我们需要自定义内容模型？

在传统的网站内容管理中，我们常常会遇到一个问题：所有内容似乎都被迫塞进“文章”或“新闻”的通用框架里。但实际业务场景远比这复杂：

  • 电商网站需要展示商品的价格、库存、SKU、品牌、材质等详细参数。
  • 房产中介需要管理房屋的面积、户型、地理位置、租金、朝向等信息。
  • 招聘平台需要发布职位名称、岗位职责、任职要求、薪资范围、工作地点等。
  • 活动策划公司则需要展示活动主题、时间、地点、参与方式、报名截止日期等。

如果仅仅使用一个简单的文本编辑器来承载这些差异巨大的信息，不仅内容输入会变得混乱，前台展示时也难以统一和美观，更重要的是，搜索引擎也无法很好地理解这些内容的具体含义，影响网站的SEO表现。AnQiCMS 的自定义内容模型正是为了解决这些痛点而生，它允许您为不同类型的内容定义专属的数据结构，满足个性化的内容展示需求。

AnQiCMS 内容模型的核心概念

在 AnQiCMS 中，“内容模型”可以理解为一种内容类型的抽象定义，它决定了该类型内容的字段构成、输入方式和展示规则。系统内置了“文章模型”和“产品模型”这两种常见的内容模型，作为快速搭建网站的基础。但其真正的强大之处在于，您可以基于业务需求，创建无限个自定义的内容模型。

内容模型与分类和文档之间存在清晰的层级关系：

  • 内容模型：是最高层级的定义，它规定了某种类型内容应该包含哪些字段。例如，“新闻模型”可能包含“标题”、“发布时间”、“作者”、“正文”等字段；“课程模型”则可能包含“课程名称”、“讲师”、“开课时间”、“课程时长”等字段。
  • 分类：每个分类都必须归属于一个特定的内容模型。这意味着，当您创建一个“公司新闻”分类时，它会继承“新闻模型”的字段结构；当您创建“手机商品”分类时，它则会继承“产品模型”的字段结构。通过分类，您可以进一步细化内容类型，但其底层数据结构仍由内容模型决定。
  • 文档：即具体的文章、产品、活动等内容条目。每个文档都必须发布在一个特定的分类下，因此它自然也遵循该分类所属内容模型的字段结构。

这种设计确保了内容的严谨性和可管理性，您在后台录入内容时，会看到针对该内容模型预设的专属输入框，而非一个万能的通用表单。

如何在 AnQiCMS 中自定义内容模型

自定义内容模型的过程直观且强大，主要在 AnQiCMS 后台的“内容管理”模块中进行操作。

  1. 进入内容模型管理：登录 AnQiCMS 后台，在左侧导航栏找到“内容管理”，点击进入后选择“内容模型”。您会看到系统内置的“文章模型”和“产品模型”，也可以点击“添加新模型”来创建自己的内容类型。
  2. 创建或修改模型基础信息：
    • 模型名称：这是您在后台识别该模型的中文名称，例如“招聘职位”、“房源信息”。它也会在某些情况下作为前台面包屑导航的显示名字。
    • 模型表名：这是一个关键的内部标识，通常是英文小写字母，它决定了该模型的数据在数据库中的存储位置。虽然系统会自动生成，但了解其作用有助于理解系统架构。
    • URL 别名：同样是英文小写字母，用于构建该模型内容的伪静态URL。例如，如果模型名称是“招聘职位”，URL别名可以设置为“job”，那么相关页面URL可能就包含/job/。这对于SEO非常重要。
    • 标题名称：这个设置很人性化。比如您创建的是“产品模型”，您可以将标题名称设置为“产品名称”；创建“课程模型”，设置为“课程标题”。这样，内容编辑者在发布该模型下的文档时，会看到更贴切的标题提示，提升操作体验。
  3. 核心：自定义内容模型字段：这是实现个性化内容展示的“魔法”所在。在模型设置页面，您可以为该模型添加专属的字段，而不是仅仅依赖于“标题”和“正文”。
    • 参数名：这是字段的显示名称，会呈现在后台内容编辑界面。例如，“房屋面积”、“学历要求”、“活动海报”。
    • 调用字段：这是该字段在数据库中存储的名称，也是您在模板中调用该数据时需要使用的标识。通常使用英文，例如“area”、“education”、“poster”。这是一个连接后台数据和前台展示的重要桥梁。
    • 字段类型：AnQiCMS 提供了多种字段类型，以适应不同数据的录入和展示需求：
      • 单行文本：适用于短文本输入，如产品型号、联系人姓名。
      • 数字：确保输入的是数值，如价格、库存、年龄。
      • 多行文本：适用于较长文本，如商品详情、职位描述，通常会配合富文本编辑器。
      • 单项选择/多项选择/下拉选择：提供预设选项供选择，如商品颜色（单选）、兴趣爱好（多选）、城市列表（下拉）。这些类型的选项在“默认值”中以一行一个的方式设置。
    • 是否必填：您可以设置某个字段是否为必填项，强制内容编辑者提供完整信息。
    • 默认值：为字段预设一个初始值，提高内容录入效率，对于选择类字段，这里用于定义可供选择的选项。

通过这些自定义字段的组合，您可以为任何类型的内容构建出最适合其数据结构的模型。

将自定义内容模型应用到实际展示

定义好内容模型后，下一步就是如何在网站前台将这些结构化的数据优雅地展示出来。AnQiCMS 通过其强大的模板引擎，让自定义字段的调用变得异常便捷。

当您在后台某个分类下添加文档时，如果该分类归属于您自定义的模型，您会发现内容编辑界面除了常规的标题、正文等，还会出现您在模型中定义的那些自定义字段。编辑者只需按照提示填写即可。

在前台模板中，调用这些自定义字段主要有两种方式：

  1. 直接通过文档对象调用：对于大部分简单的自定义字段，您可以直接通过 archive.调用字段名 的形式来获取。例如，如果您为“产品模型”定义了一个名为“品牌”（调用字段为 brand）的单行文本字段，在产品详情页的模板中，您可以这样显示品牌信息： “`twig

    品牌