如何自定义内容模型，使其在前端页面中以独特方式显示不同类型内容（如文章、产品）？

在安企CMS中，内容模型的自定义能力是其核心优势之一，它赋予了我们极大的灵活性，让网站能够跳出传统“文章”和“页面”的束缚，根据实际业务需求来组织和展示各式各样的信息。无论是复杂的电商产品详情，还是精炼的企业案例展示，都可以通过自定义内容模型，在前端页面上呈现出独一无二的风格和功能。

理解内容模型的重要性

内容模型，简单来说，就是你网站上内容的“骨架”或“蓝图”。它定义了每种类型内容应该包含哪些字段，例如一篇文章可能包含“标题”、“作者”、“发布日期”、“内容”等字段，而一个产品则可能需要“产品名称”、“价格”、“库存”、“品牌”、“详细描述”以及“多图展示”等。

安企CMS之所以强调其灵活的内容模型，是因为它深刻理解到不同类型的网站或业务对内容结构的需求是千差万别的。通过自定义内容模型，我们可以：

  • 实现精细化管理： 针对不同类型的内容，设置专属的数据字段，避免冗余信息，提升后台管理效率。
  • 优化前端展示： 根据自定义的字段，在前端页面上以更符合内容特性、更具吸引力的方式展现信息，提升用户体验。
  • 提升SEO效果： 为特定内容类型定制URL结构和TDK（标题、描述、关键词），更好地迎合搜索引擎优化需求。
  • 增强系统适应性： 无论是搭建企业官网、产品展示站还是自媒体博客，都能快速适应并扩展内容类型。

在安企CMS中创建和管理自定义内容模型

要开始自定义内容模型，我们需要进入安企CMS的后台管理界面。通常，你可以在左侧导航栏找到“内容管理”选项，点开后，会看到“内容模型”。这里是所有内容模型（包括系统内置的文章、产品模型和用户自定义模型）的管理中心。

点击“添加模型”或编辑现有模型，你将看到以下几个关键的设置项：

  1. 模型名称： 这是模型在后台和用户界面上的中文名称，比如“新闻动态”、“解决方案”、“服务项目”等，应清晰易懂。
  2. 模型表名： 这是一个非常关键的设置。它定义了该模型的数据在数据库中存储的表名，并且前端模板会依据这个表名来寻找对应的模板文件。例如，如果你将模型表名设置为 solution，那么对应的列表页和详情页模板就可能分别命名为 solution/list.html 和 solution/detail.html。这个表名通常由英文小写字母组成，确保唯一性。
  3. URL别名： 这是用于前端URL的标识，通常也是英文小写，方便生成伪静态链接。
  4. 标题名称： 这个字段会提示在发布该模型内容时，“标题”输入框旁的文字。例如，如果模型是“产品”，这里可以设置为“产品名称”，让编辑人员一目了然。

重中之重是内容模型自定义字段。这是内容模型真正灵活多变的核心所在。在这里，你可以为当前模型添加独有的字段，以满足特定类型内容的展示需求。比如：

  • 对于一个“产品”模型，你可能需要添加“价格”（数字类型）、“库存”（数字类型）、“品牌”（单行文本）、“适用场景”（多项选择）和“产品亮点”（多行文本）等字段。
  • 对于一个“团队成员”模型，你可能需要“职位”（单行文本）、“工作经验”（多行文本）和“个人简介图片”（单行文本，用于存储图片URL）等。

在添加自定义字段时，你需要指定：

  • 参数名： 字段的中文显示名称，如“产品价格”。
  • 调用字段： 字段在数据库和模板中被调用的英文名称，如 price。
  • 字段类型： 包括单行文本、数字、多行文本、单项选择、多项选择和下拉选择等。选择合适的字段类型，不仅方便后台编辑，也影响前端数据获取和展示的方式。
  • 是否必填： 根据内容需求决定该字段是否必须填写。
  • 默认值： 为字段设置预设值。对于选择类型字段，默认值就是其可选的项目列表，一行一个。

这些自定义字段的加入，让你的每种内容类型都拥有了独特的“基因”，为前端的个性化展示打下了坚实的基础。

打造专属前端展示：模板与自定义内容模型的结合

后端定义了数据的结构，前端则决定了这些数据如何被呈现。安企CMS的模板系统与内容模型紧密相连，允许我们为每种内容模型设计一套专属的视觉风格和布局。

  1. 模板文件的命名与存放： 安企CMS的模板文件默认存放在 /template 目录下。为了让系统自动识别并应用，自定义内容模型的模板文件通常会遵循特定的命名约定：

    • 模型列表页： /template/{模型表名}/list.html，例如 product/list.html。
    • 模型详情页： /template/{模型表名}/detail.html，例如 product/detail.html。
    • 分类列表页： 如果分类也需要自定义模板，可以是 /template/{模型表名}/list-{分类ID}.html。

    这意味着，当你访问一个产品列表页时，系统会根据该列表所属的模型表名去寻找对应的 list.html；当你点击一个产品进入详情页时，则会寻找 detail.html。

  2. 在模板中调用内容： 在模板文件中，我们可以使用安企CMS提供的标签（Tag）和变量来获取和展示自定义内容模型中的数据。

    • 获取单个内容详情（如产品详情页）： 使用 archiveDetail 标签来获取当前内容的详细信息。如果你在自定义模型中添加了 price 和 stock 字段，你可以这样调用它们：

      {# 获取当前产品标题 #}
<h1>{% archiveDetail with name="Title" %}</h1>
{# 获取产品价格 #}
<p>价格：{% archiveDetail with name="price" %}</p>
{# 获取产品库存，并根据库存量显示不同信息 #}
{% if archive.stock > 0 %}
    <p>库存：有货（剩余 {{ archive.stock }} 件）</p>
{% else %}
    <p>库存：缺货</p>
{% endif %}
{# 获取产品描述 #}
<div class="description">{% archiveDetail with name="Content"|safe %}</div>

      这里，archive.stock 假设是直接访问上下文中的变量。如果需要明确通过 archiveDetail 标签获取，则可以使用 {% archiveDetail archiveStock with name="stock" %}{{ archiveStock }} 这样的方式。对于自定义字段，直接使用 archive.字段名 的形式通常更为简洁高效。

    • 获取内容列表（如产品列表页或文章列表页）： 使用 archiveList 标签来获取某个内容模型的列表数据。通过 moduleId 参数，可以指定只获取特定模型的内容。

      {% archiveList products with moduleId="2" type="page" limit="10" %}
    {% for item in products %}
    <div class="product-item">
        <h2><a href="{{ item.Link }}">{{ item.Title }}</a></h2>
        <img src="{{ item.Logo }}" alt="{{ item.Title }}">
        {# 调用自定义价格字段 #}
        <p>售价：¥{{ item.price }}</p>
        {# 调用自定义产品亮点字段（假设是多行文本） #}
        <div class="features">{{ item.highlight|safe }}</div>
    </div>
    {% endfor %}
    {# 配合分页标签展示分页信息 #}
    {% pagination pages with show="5" %}{% endpagination %}
{% endarchiveList %}

      这里的 item.price 和 item.highlight 同样是假设直接访问列表项中的自定义字段。请注意，当自定义字段是多行文本或富文本时，可能需要使用 |safe 过滤器来确保HTML内容的正确解析，而不是被转义。

    • 展示多图字段： 如果你的产品模型有一个名为 product_images 的多图字段（通常以数组形式返回图片URL），你可以在详情页或列表页这样循环展示：

      {% archiveDetail images with name="product_images" %}
<div class="product-gallery">
    {% for img_url in images %}
        <img src="{{ img_url }}" alt="产品图片">
    {% endfor %}
</div>
{% endarchiveDetail %}

      或者，如果直接访问 `archive.product_