如何自定义安企CMS首页的内容展示布局？

您的网站首页是访客的第一印象，也是品牌形象和核心内容展示的窗口。如何让这扇“门面”既美观又高效地传达信息，是每个网站运营者都关心的问题。安企CMS（AnQiCMS）作为一个注重定制化和灵活性的内容管理系统，为我们提供了非常便捷的方式来随心所欲地打造专属的首页布局。

要自定义安企CMS首页的内容展示布局，我们主要围绕其强大的模板系统和内容标签来展开。系统设计的核心理念就是让用户能够轻松地将后台的数据动态呈现在前端页面上，同时支持高度灵活的布局调整。

深入理解模板文件结构

安企CMS 首页内容的展示布局，核心在于其灵活且强大的模板系统。所有网站页面的呈现，都离不开位于 /template 目录下的模板文件。通常，我们会在这里找到你当前使用的模板文件夹，例如 default。

在你的模板文件夹中，index/index.html（或扁平化结构下的 index.html）就是首页的入口文件。它是定义首页整体结构和内容展示逻辑的地方。

安企CMS 的模板语法类似 Django 模板引擎，上手非常容易。数据变量使用双花括号 {{变量}} 来输出，而条件判断、循环控制等逻辑标签则使用单花括号和百分号 {% 标签 %} 来定义，并且需要相应的结束标签，如 {% if 条件 %}...{% endif %}。

在编辑模板时，我们通常会利用 extends 和 include 这两个辅助标签。extends 标签允许我们继承一个基础模板（比如 base.html），从而复用公共的页头、页脚、侧边栏等结构，避免重复编写代码。而 include 标签则能将一些小的、可复用的代码片段（例如新闻列表模块、产品展示块）嵌入到主模板中，让代码更加模块化，便于管理和维护。

运用安企CMS的强大标签获取内容

仅仅是静态的 HTML 骨架还不够，我们需要将后台管理的内容动态地呈现在首页上。安企CMS 提供了一系列功能强大的模板标签，它们就像是数据搬运工，能够帮助我们从后台调取各种类型的内容，并按照我们的布局需求进行展示。

首先，网站的基础信息是必不可少的。我们可以使用 system 标签来获取网站的名称、Logo、备案号等全局设置信息，例如：

<img src="{% system with name="SiteLogo" %}" alt="{% system with name="SiteName" %}" />

接着，导航菜单是引导访客浏览网站的重要元素。navList 标签能够方便地调取后台“导航设置”中配置的菜单项，支持多级导航，让我们可以轻松构建网站的主导航或页脚导航：

{% navList navs %}
<ul>
    {% for item in navs %}
        <li><a href="{{ item.Link }}">{{item.Title}}</a></li>
    {% endfor %}
</ul>
{% endnavList %}

对于首页的视觉焦点，比如轮播图，bannerList 标签就能派上用场。它会获取后台配置的首页 Banner 列表，让我们可以在首页上展示吸引人的幻灯片：

{% bannerList banners %}
    {% for item in banners %}
        <a href="{{item.Link}}"><img src="{{item.Logo}}" alt="{{item.Alt}}" /></a>
    {% endfor %}
{% endbannerList %}

如果首页需要展示特定分类下的文章或产品，categoryList 和 archiveList 标签是我们的得力助手。例如，我们想要展示“新闻资讯”分类下的最新文章，或者“产品展示”分类下的热门产品：

{# 展示文章模型下ID为1的分类（如新闻资讯）的最新10篇文章 #}
{% archiveList archives with moduleId="1" categoryId="1" limit="10" order="id desc" %}
    {% for item in archives %}
        <h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
        <p>{{item.Description|truncatechars:100}}</p>
    {% endfor %}
{% endarchiveList %}

{# 展示产品模型下ID为2的分类（如热门产品）的图片列表 #}
{% archiveList products with moduleId="2" categoryId="2" limit="8" flag="c" %}
    {% for item in products %}
        <div><img src="{{item.Thumb}}" alt="{{item.Title}}" /><p>{{item.Title}}</p></div>
    {% endfor %}
{% endarchiveList %}

通过 moduleId 指定内容模型（文章或产品），categoryId 指定所属分类，limit 限制显示数量，order 控制排序方式，flag 筛选推荐属性等，我们就能精准地控制首页上各类内容的展示。

对于“关于我们”或“联系方式”等静态内容，如果它们以单页面形式存在，pageDetail 标签可以直接获取并展示。而如果这些信息是通过后台“联系方式设置”配置的，则 contact 标签能帮助我们调取相应字段。

{# 展示ID为1的单页面内容，例如“关于我们” #}
{% pageDetail pageDetail with id="1" %}
    <h2>{{pageDetail.Title}}</h2>
    <p>{{pageDetail.Description}}</p>
{% endpageDetail %}

{# 展示联系电话 #}
<p>联系电话：{% contact with name="Cellphone" %}</p>

进一步定制：内容模型与自定义字段

安企CMS 的“灵活的内容模型”是一项核心优势，它允许我们根据业务需求自定义内容模型和字段。这意味着，如果内置的文章、产品字段无法满足你的展示需求，你可以创建新的字段（例如为产品添加“材质”、“尺寸”等自定义参数），然后在模板中通过 archiveParams 标签或直接通过 archiveDetail with name="自定义字段名" 的方式来获取并显示这些额外的数据。这对于构建高度专业化的产品展示页或信息丰富的服务介绍模块至关重要。

同时，结合 if 逻辑判断和 for 循环遍历标签，我们可以实现更复杂的布局逻辑。例如，判断某个区域是否有内容，有则展示，无则隐藏；或者根据数据类型显示不同的样式。filters（过滤器）也能在输出时对内容进行格式化，比如 truncatechars 用于截断文本，safe 用于安全输出 HTML 内容，让页面的呈现更加精细。

后台管理是前端定制的基础

虽然我们专注于代码层面，但不要忘记，所有这些前端的自定义展示，都离不开后台的细致配置。在安企CMS 的后台管理界面，以下几个区域与首页内容的定制息息相关：

• 后台设置 -> 全局功能设置：这里设置网站的名称、Logo、备案号、移动端地址等，这些信息会通过 system 标签在前端调用。
• 后台设置 -> 导航设置：管理网站的导航菜单结构，直接影响 navList 标签的输出。
• 内容管理 -> 文档分类 & 内容模型 & 文档管理：这是所有动态文章、产品内容的源头。自定义模型和字段、创建分类、发布文档，都将在此完成，并由 archiveList、categoryList 等标签调取。
• **页面资源 -> 页面管理