如何根据后台自定义内容模型字段在前台展示个性化信息？

揭秘安企CMS：如何巧妙运用后台自定义字段，打造前台个性化内容展示

在当今瞬息万变的数字世界里，网站不仅仅是信息的载体，更是品牌个性与用户体验的窗口。传统的网站内容管理系统（CMS）往往受限于固定的内容结构，难以满足千变万化的业务需求。然而，安企CMS（AnQiCMS）以其灵活的内容模型和强大的自定义字段功能，为网站运营者打开了全新的个性化内容展示之门。

想象一下，您的网站不再是千篇一律的博客文章列表，而是根据不同产品、服务或活动展示独有的属性信息，例如产品详细参数、活动报名状态、房屋租赁特色等。这些个性化信息的呈现，正是通过安企CMS后台自定义内容模型字段在前台展示的精髓所在。

一、内容模型：构建您的专属内容骨架

在安企CMS中，内容模型（Content Model）是定义网站内容结构的基础。系统默认提供了“文章模型”和“产品模型”，它们就像是预设好的内容蓝图。但真正的强大之处在于，您可以根据业务需求，创建全新的内容模型，或者对现有模型进行深度定制。

例如，如果您运营一个房地产中介网站，您可能需要一个“房源模型”。这个模型除了标题、内容等通用字段外，还需要“房屋面积”、“户型”、“装修情况”、“学区房标记”等独特属性。这些独特属性，正是通过自定义字段来实现的。

二、后台配置：精心雕琢您的自定义字段

创建或编辑内容模型时，进入“内容模型自定义字段”选项卡，您便能开始定义这些个性化的信息项。这里有几个关键点需要留意：

  1. 参数名（显示名称）：这是在后台编辑内容时，用户看到的字段名称，应清晰易懂，例如“房屋面积”。
  2. 调用字段（字段名）：这是在前端模板中调用数据时使用的唯一标识符。请务必使用英文字母，且在同一个模型中保持唯一性，例如“houseArea”。这是一个非常重要的字段，它连接着后台数据与前台展示。
  3. 字段类型：安企CMS提供了多种字段类型，以适应不同数据的存储需求：
    • 单行文本/多行文本：适用于简短描述或长篇介绍。
    • 数字：确保输入的数据为数值型，便于后续进行排序或筛选。
    • 单项选择/多项选择/下拉选择：这些类型允许您预设选项列表。在定义时，每个选项占据一行，方便后台人员选择。它们在前台展示时，通常会显示选定的值。
  4. 是否必填与默认值：根据业务逻辑设置字段是否必须填写，以及是否有初始默认值。

当您在内容模型中添加了这些自定义字段后，发布或编辑该模型下的内容时，便能在后台找到对应的输入框，填入具体的数据。例如，编辑一篇房源信息时，您可以为“houseArea”字段填入“120平方米”。

三、前台展示：让数据跃然于页面之上

完成后台配置和数据录入后，接下来就是如何在网站前台将这些个性化信息呈现给用户。安企CMS的模板引擎提供了直观且强大的标签（Tags）来完成这项任务。

  1. 获取单个自定义字段值：archiveDetail 标签

    如果您想在文章或产品详情页直接显示某个特定的自定义字段，可以使用 archiveDetail 标签。

    例如，您想展示房源的“房屋面积”（调用字段为 houseArea），可以在详情页模板中这样写：

    <div>房屋面积：{% archiveDetail with name="houseArea" %}</div>

    如果这个字段是可选的，您可能需要判断它是否存在，避免显示空值：

    {% archiveDetail houseAreaValue with name="houseArea" %}
{% if houseAreaValue %}
    <div>房屋面积：{{ houseAreaValue }}</div>
{% endif %}

  2. 循环展示所有自定义字段：archiveParams 标签

    在某些情况下，您可能希望将所有自定义字段以列表形式展示出来，例如在产品参数区域。这时，archiveParams 标签便能派上用场。它会返回一个包含所有自定义字段名称 (item.Name) 和值 (item.Value) 的数组。

    <div class="product-params">
    <h4>房源特色</h4>
    {% archiveParams params %}
        <ul>
        {% for item in params %}
            <li>
                <span>{{ item.Name }}：</span>
                <span>{{ item.Value }}</span>
            </li>
        {% endfor %}
        </ul>
    {% endarchiveParams %}
</div>

    通过这种方式，即使您未来增加了新的自定义字段，前端也无需修改模板代码，新字段将自动显示。

  3. 处理特殊类型的自定义字段

    • 图片组字段：如果您自定义了一个用于上传多张图片的字段（例如 houseImages），您可以像这样循环显示它们： 
      
{% archiveDetail houseImagesList with name="houseImages" %}
<div class="house-gallery">
    {% for img in houseImagesList %}
        <img src="{{ img }}" alt="房源图片">
    {% endfor %}
</div>
    • 富文本内容（多行文本且支持HTML）：如果您的多行文本字段存储的是带有HTML格式的内容，请务必使用 |safe 过滤器来防止内容被转义，确保HTML标签正确渲染： 
      
{% archiveDetail detailDesc with name="detailDescription" %}
<div class="house-description">
    {{ detailDesc|safe }}
</div>

  4. 利用自定义字段进行内容筛选：archiveFilters 标签

    自定义字段不仅可以展示，更可以成为用户筛选内容的强大工具。例如，在房源列表页，用户可能想根据“户型”或“装修情况”进行筛选。archiveFilters 标签可以帮助您构建这样的筛选界面。

    您需要在列表页模板中放置 archiveFilters 标签，并结合 archiveList 标签进行内容的动态加载。

    <div class="filter-area">
    {% archiveFilters filters with moduleId="您的房源模型ID" allText="全部" %}
        {% for item in filters %}
            <div class="filter-group">
                <span>{{ item.Name }}:</span>
                {% for val in item.Items %}
                    <a href="{{ val.Link }}" class="{% if val.IsCurrent %}active{% endif %}">{{ val.Label }}</a>
                {% endfor %}
            </div>
        {% endfor %}
    {% endarchiveFilters %}
</div>


<div class="house-listings">
    {% archiveList archives with type="page" moduleId="您的房源模型ID" limit="10" %}
        {# 在这里循环展示筛选后的房源列表 #}
    {% endarchiveList %}
</div>

    当用户点击筛选条件时，URL会自动带上对应的参数，archiveList 标签便能根据这些参数获取并显示筛选后的内容。

四、实践建议与**实践

  • 提前规划：在定义自定义字段前，请充分梳理业务需求，明确每个字段的用途、类型和展示方式。良好的前期规划能大大减少后期修改的成本。
  • 调用字段命名规范：