在现代网站运营中，内容的多样性和个性化展示是吸引用户、提升品牌形象的关键。安企CMS（AnQiCMS）凭借其灵活的内容模型设计，为网站内容管理带来了前所未有的自由度。当我们根据业务需求自定义了内容模型后，如何将这些具有独特结构的内容在前端页面上精巧地呈现出来，是每一个运营者都需要掌握的核心技能。
理解安企CMS的内容模型与灵活基石
安企CMS的核心优势之一，就是它提供了“灵活的内容模型”功能。这意味着我们不再局限于传统的“文章”或“产品”概念，而是可以根据实际业务场景，定义任何我们想要的内容类型。例如，您可以创建一个“课程”模型来管理在线学习资料，一个“房源”模型来展示房地产信息，或者一个“团队成员”模型来介绍公司员工。
在创建这些自定义内容模型时，您可以根据需要添加各种“自定义字段”。这些字段就像内容的骨架，可以是简单的单行文本、数字，也可以是更复杂的图片组、多行文本编辑器，甚至是下拉选择、单选或多选框。正是这些自定义字段，赋予了内容模型独特的结构和丰富的数据维度。例如，一个“课程”模型可以有“课程名称”、“主讲人”、“课程大纲（多行文本）”、“课程封面图”和“难度等级（下拉选择）”等字段。
这种高度可定制化的内容结构，是安企CMS实现前端灵活展示的基石。它确保了后端存储的数据与我们预期的前端表现形式能够完美契合。
前端模板的魔力：Django 语法初探
安企CMS的前端展示得益于其类Django模板引擎的强大功能。它使用.html文件作为模板，并提供了直观易懂的语法，让不懂复杂编程的用户也能轻松上手。
在模板文件中，我们主要会遇到两种类型的语法结构：
- 双花括号
{{变量}}：这用于输出变量的内容。例如，{{archive.Title}}会直接显示当前内容的标题。 - 单花括号和百分号
{% 标签 %}：这用于执行逻辑操作，如条件判断、循环遍历或调用特定的功能标签。例如，{% if condition %}用于判断，{% for item in list %}用于循环。
所有模板文件都统一存放在/template目录下，并且模板引擎支持UTF8编码，确保了内容的正确显示。
核心策略：通用与定制化模板的结合
为了灵活展示不同结构的内容，安企CMS提供了一套强大的模板命名和调用机制。我们可以选择使用通用模板，也可以为特定内容类型或单个内容项指定专属模板。
通用模板的默认约定：安企CMS会根据模型的
模型table名称，自动匹配相应的模板文件。例如，一个名为article的模型，其内容列表页通常会查找article/list.html，详情页会查找article/detail.html。分类列表页则会查找{模型table}/list-{分类id}.html，而单个页面则可以由page/{单页面id}.html进行定制。这意味着，对于某个内容模型下的所有内容，只要它们结构相似，就可以共享一套通用模板，大大减少了重复开发的工作量。定制化模板的精细控制：当我们遇到特殊内容，需要完全不同于通用模板的布局时，安企CMS也提供了解决方案。例如，某个特定的“下载”文章，可能需要一个包含下载按钮、版本信息等特殊布局的详情页。这时，我们可以在模板目录中创建一个
download.html文件，然后在该文章的编辑界面（“其他参数”部分）的“文档模板”字段中，填写download.html。这样，该文章就会优先使用这个定制的模板进行展示，而其他文章则继续使用默认的通用模板。这种机制同样适用于分类页面和单页面，通过在后台设置“分类模板”或“单页面模板”来实现。
灵活展示自定义字段的内容
自定义字段是内容模型的核心，将其内容展现在前端是关键。安企CMS提供了两种主要方式来获取和展示这些自定义字段：
- 直接通过
archiveDetail标签获取：如果您的内容模型有一个名为author的自定义字段，您可以在详情页模板中直接使用{% archiveDetail with name="author" %}来获取其值。这种方法简洁明了，适用于您明确知道要显示哪个自定义字段的情况。 - 通过
archiveParams标签循环遍历所有自定义字段：有时候，我们可能不确定内容模型有哪些自定义字段，或者希望动态地展示所有自定义字段及其值，例如在一个产品详情页中列出所有产品规格。这时，{% archiveParams params %}{% for item in params %}{{item.Name}}：{{item.Value}}{% endfor %}{% endarchiveParams %}就显得非常有用。它会遍历内容模型中定义的所有自定义字段，并输出它们的名称和对应的值。通过sorted=true参数，您还可以确保字段按后台定义的顺序显示。
举个例子，如果您的“产品”模型中定义了“材质”、“颜色”、“尺寸”等自定义字段，您可以在产品详情页模板中这样展示：
{# 假设这是产品详情页模板 product/detail.html #}
<div class="product-info">
<h1>{{archive.Title}}</h1> {# 产品标题 #}
<img src="{{archive.Logo}}" alt="{{archive.Title}}"> {# 产品主图 #}
<div class="product-specs">
<h2>产品参数</h2>
{% archiveParams params %}
<ul>
{% for item in params %}
{# 排除一些内部字段或不需要展示的字段 #}
{% if item.FieldName != 'price' and item.FieldName != 'stock' %}
<li>
<strong>{{item.Name}}：</strong>
<span>{{item.Value}}</span>
</li>
{% endif %}
{% endfor %}
</ul>
{% endarchiveParams %}
</div>
<div class="product-description">
<h2>产品详情</h2>
{# archive.Content是富文本内容，使用safe过滤器防止HTML转义 #}
{{archive.Content|safe}}
</div>
</div>
在这个例子中，archive.Title和archive.Logo是安企CMS内置的字段，而“产品参数”部分则通过archiveParams动态地展示了所有自定义的产品规格。
场景化应用：不同内容类型的展示案例
文章详情页：一个典型的文章详情页可能包含标题、发布时间、分类、标签和正文。除了内置字段，您可能还会有一个自定义的“文章来源”字段。
<h1>{{archive.Title}}</h1> <p>发布于：{{stampToDate(archive.CreatedTime, "2006-01-02")}} | 分类：<a href="{{category.Link}}">{{category.Title}}</a> | 来源：{% archiveDetail with name="source" %}</p> <div class="article-content">{{archive.Content|safe}}</div>这里，
stampToDate过滤器用于格式化时间戳，category.Link和category.Title则通过内置的archive.Category对象获取当前文章所属分类的信息。产品列表页：如果您有一个“产品”模型，其列表页可能需要展示产品图片、名称、价格以及一个自定义的“主要卖点”字段。
{% archiveList products with type="page" moduleId="2" limit="10" %} {% for product in products %} <div class="product-card"> <a href="{{product.Link}}"> <img src="{{product.Thumb}}" alt="{{product.Title}}"> <h3>{{product.Title}}</h3> <p class="price">¥ {% archiveDetail with name="price" id=product.Id %}</p> <p class="selling-point">{% archiveDetail with name="selling_point" id=product.Id %}</p> </a> </div> {% endfor %} {% pagination pages with show="5" %} {# 展示分页 #} {% endarchiveList %}在这个例子中，
archiveList获取产品列表，并通过product.Id结合archiveDetail获取每个产品的自定义价格和卖点字段。单页面：对于“关于我们”页面，除了常规内容，您可能还希望展示一个背景大图（自定义字段`