作为一名资深的网站运营专家，深知内容呈现的灵活性对于用户体验和运营效率至关重要。安企CMS（AnQiCMS）凭借其强大的模板引擎和内容模型机制，为我们提供了实现这种灵活性的强大工具。今天，我们就来深入探讨一个非常实用的场景：如何在categoryList循环中，根据不同的moduleId，智能地展示各具特色的内容。
巧用moduleId，让安企CMS分类列表内容千变万化
在安企CMS的模板开发中，categoryList标签无疑是构建导航、分类区块的核心。它允许我们轻松地遍历网站的分类结构。然而，网站的内容往往是多样的，我们可能既有文章、也有产品、服务等不同类型的信息。当这些不同类型的内容被归类到不同的“内容模型”下时，如何在同一个分类列表中，根据分类所属的内容模型（即moduleId）来展示不同的内容布局和信息，就成为了一个进阶的课题。
安企CMS的模板引擎支持Django风格的语法，这意味着我们可以利用强大的条件判断和循环结构来实现高度定制化的内容展示。其中，moduleId就是连接分类与内容模型，并实现动态展示的关键“桥梁”。
理解categoryList与moduleId的协作
首先，我们知道{% categoryList categories %}标签能够获取一系列的分类数据。在循环体内，每个分类对象通常命名为item，它包含了该分类的各种属性，如item.Id、item.Title、item.Link等等。
而item.ModuleId这个属性，正是我们今天的主角。它记录了当前分类所关联的内容模型的ID。根据安企CMS的默认设置，文章模型通常对应moduleId=1，产品模型则对应moduleId=2。如果我们自定义了其他内容模型，它们也会有相应的moduleId。
有了item.ModuleId，我们就可以在categoryList的循环内部，根据不同的模型ID执行不同的逻辑，从而展示出完全不同的内容布局。这就像为每个分类内容模型量身定制了一个“显示模式”。
核心技术：if条件判断的妙用
实现这一目标的核心，在于在categoryList循环中使用if标签进行条件判断。基本的结构会是这样：
{% categoryList categories with parentId="0" %}
{% for item in categories %}
<div class="category-block">
<h3><a href="{{ item.Link }}">{{item.Title}}</a></h3>
{% if item.ModuleId == 1 %}
{# 文章模型的分类，展示文章列表 #}
<div class="articles-list">
<h4>最新文章</h4>
<ul>
{% archiveList archives with type="list" categoryId=item.Id limit="5" %}
{% for archive in archives %}
<li>
<a href="{{archive.Link}}">{{archive.Title}}</a>
<span>({{stampToDate(archive.CreatedTime, "2006-01-02")}} - {{archive.Views}}阅读)</span>
</li>
{% empty %}
<li>暂无文章内容</li>
{% endfor %}
{% endarchiveList %}
</ul>
</div>
{% elif item.ModuleId == 2 %}
{# 产品模型的分类，展示产品图片和名称 #}
<div class="products-grid">
<h4>热门产品</h4>
<ul class="product-items">
{% archiveList products with type="list" categoryId=item.Id limit="4" %}
{% for product in products %}
<li>
<a href="{{product.Link}}">
<img src="{{product.Thumb}}" alt="{{product.Title}}" loading="lazy">
<p>{{product.Title}}</p>
<span class="price">${{product.Price}}</span>
</a>
</li>
{% empty %}
<li>暂无产品内容</li>
{% endfor %}
{% endarchiveList %}
</ul>
</div>
{% else %}
{# 其他模型的分类，或者默认展示方式 #}
<div class="default-content">
<p>这是一个特殊的分类：{{item.Title}}，其所属模型ID为：{{item.ModuleId}}。</p>
<a href="{{ item.Link }}">查看更多</a>
</div>
{% endif %}
</div>
{% endfor %}
{% endcategoryList %}
在这段代码中，我们首先使用categoryList获取顶级分类。然后，在每个分类item的循环中，我们通过{% if item.ModuleId == 1 %}和{% elif item.ModuleId == 2 %}来判断当前分类属于哪种内容模型。
- 如果
item.ModuleId是1（文章模型），我们就在这个区块内使用archiveList标签，并传入当前分类的ID (categoryId=item.Id)来获取该分类下的最新文章，并以标题和发布日期、阅读量的方式简洁展示。 - 如果
item.ModuleId是2（产品模型），我们则同样使用archiveList，获取该分类下的产品，但展示方式变为产品缩略图、名称和价格，更符合产品展示的需求。 - 最后的
{% else %}部分则作为一个通用或备用的展示方式，可以用于处理未知的moduleId或作为一种默认显示。
这种方式的优势在于，它将不同内容模型的展示逻辑封装在各自的条件分支中，代码结构清晰，易于维护和扩展。当需要增加新的内容模型时，只需添加新的elif分支即可。
**实践与注意事项
- 明确
moduleId对应关系： 在后台的“内容管理”->“内容模型”中，你可以查看到每个内容模型的详细信息，包括其ID。务必记住或记录下常用的moduleId值，以便在模板中准确引用。 - 嵌套
archiveList： 通常，我们希望在分类列表中展示的是该分类下的具体文档内容，而不是仅仅分类本身的描述。因此，在categoryList的循环内部嵌套archiveList标签，并使用categoryId=item.Id来关联当前分类是常见且高效的做法。 - 善用
limit参数： 为了页面加载速度和布局美观，在archiveList中合理设置limit参数，限制每个分类下展示的文档数量。 - 模块化模板： 当
if分支内的内容区块变得复杂时，考虑使用{% include "partial/article_preview.html" with archives=archives %}等方式，将每个模型类型的显示逻辑拆分到单独的模板片段中，以提高代码的可读性和复用性。 - 性能考量： 虽然AnQiCMS基于Go语言开发，性能出色，但过多的嵌套循环或复杂查询仍然可能影响页面加载。合理设计数据结构，避免在一次请求中加载过多不必要的数据。
通过这种方式，我们可以在网站的任意页面（如首页、侧边栏