如何控制不同内容模型（如文章、产品）在前端的展示方式？
在安企CMS中，灵活地控制不同内容模型（例如文章、产品、案例等）在网站前端的展示方式，是提升用户体验和满足多样化业务需求的关键。系统提供了一套强大且易于理解的机制，让您能够根据内容类型和具体需求，精细化地设计和管理页面的呈现效果。
理解内容模型的基础作用
首先，我们要明白内容模型在安企CMS中的核心地位。内容模型不仅仅是定义了内容的结构，更是决定了您可以为不同类型的内容收集哪些数据。当您创建或编辑一个内容模型时，比如“文章”模型或“产品”模型，您可以自定义一系列的字段，如文章的“作者”、“来源”，或者产品的“价格”、“库存”、“颜色选项”等。这些自定义字段是前端展示个性化内容的基础，它们将成为您在模板中调用和呈现的独特数据。正是这些字段，让“文章”不仅仅是标题和正文，也让“产品”拥有了丰富的属性细节。
通过模板实现前端展示的多样化
安企CMS采用了一套类似于Django的模板引擎，通过HTML文件和特定的标签语法，您可以完全掌控页面的布局和内容显示。
模型级模板定制： 系统为每个内容模型都预设了默认的展示模板。例如，所有文章通常会使用
article/detail.html作为详情页模板，所有产品会使用product/detail.html。同样，列表页也有对应的{模型table}/list.html。这些是模型层面的通用模板，为该模型下的所有内容提供了一个统一的展示框架。您可以编辑这些默认模板，为您的文章或产品设定整体的视觉风格。分类级模板细化： 当您希望同一模型下的不同分类拥有不同的展示样式时，安企CMS提供了分类模板的功能。在编辑某个分类时，您可以为其指定一个“分类模板”（用于该分类的列表页）和/或一个“文档模板”（用于该分类下的所有内容详情页）。例如，“新闻资讯”分类下的文章可以与“技术文章”分类下的文章使用不同的详情模板。更进一步，您还可以选择将分类模板的设置应用到其所有子分类，从而简化管理。
单文档模板覆盖： 对于某些特殊的、需要独特展示效果的单篇内容，系统也提供了终极的灵活性。在发布或编辑具体文档（无论是文章还是产品）时，您可以为其单独指定一个“文档模板”。这个模板将优先于模型级和分类级的模板设置，确保该文档以您指定的方式呈现。这在需要突出展示某个重要产品或发布一篇特殊公告时非常有用。
利用自定义字段控制展示： 个性化展示的核心在于如何有效地利用内容模型中定义的自定义字段。比如，一个“产品”模型可能包含“产品尺寸”、“材质”、“适用人群”等字段，而“文章”模型可能包含“阅读时长”、“推荐等级”等。这些字段的值可以直接在模板中调用，并根据其内容进行条件判断，从而实现动态的页面布局。比如，如果某个产品有促销价，模板可以判断“促销价”字段是否存在，进而决定是否显示“原价”并添加删除线。
在模板中精准调用与渲染内容
在实际的模板文件中，您将使用安企CMS提供的各种模板标签和过滤器来获取和处理内容数据：
获取内容详情： 使用
archiveDetail标签可以获取当前页面或指定ID内容的详细信息，包括标题、正文、缩略图，以及最重要的——各种自定义字段。例如，{% archiveDetail with name="Title" %}会显示当前文档的标题，而{% archiveDetail with name="price" %}则可能显示产品的价格（如果您的产品模型有price这个自定义字段）。遍历自定义参数： 对于内容模型中复杂的自定义字段（如多选、下拉选择），或者您需要遍历所有自定义字段来动态生成表格或列表时，
archiveParams标签就显得尤为重要。它可以获取指定文档的所有自定义参数，并允许您通过for循环逐一展示它们的名称和值。展示内容列表：
archiveList标签是构建列表页面的利器。它支持按模型、分类、推荐属性、排序方式等多种条件获取内容列表，并且可以结合分页标签pagination实现完善的列表展示功能。逻辑控制与数据处理：
if标签用于条件判断，例如判断某个自定义字段是否有值再决定是否显示；for标签用于循环遍历列表或数组。同时，别忘了各种实用的过滤器，如safe用于安全输出HTML内容，thumb用于获取图片缩略图，stampToDate用于格式化时间戳，以及render用于将Markdown内容渲染成HTML，这些都能帮助您更好地格式化和呈现数据。
通过上述多层次的模板配置和强大的模板标签功能，安企CMS确保您能够根据任何内容模型、分类甚至单篇内容的具体需求，打造出独具特色且高度定制化的前端展示效果。
常见问题 (FAQ)
问：我想为“产品”模型下的“手机”分类和“电脑”分类设置完全不同的列表页布局，应该如何操作？ 答：您可以在后台的“内容管理”->“文档分类”中，分别编辑“手机”和“电脑”这两个分类。在分类的编辑界面，找到“分类模板”选项，为它们指定不同的模板文件，例如
product/list-phone.html和product/list-computer.html。这样，用户访问这两个分类时，系统就会加载对应的模板来渲染列表页。问：我的“文章”模型有一个自定义字段叫“推荐指数”，只有当推荐指数大于5时，才在文章详情页的标题下方显示一个“热门推荐”的标识，这能实现吗？ 答：完全可以。首先，确保您的“文章”模型中已设置“推荐指数”这个数字类型的自定义字段。然后在您的文章详情模板（如
article/detail.html）中，可以使用archiveDetail标签获取该字段的值，并结合if逻辑判断来控制显示。大致代码会是这样：{% archiveDetail recommendIndex with name="推荐指数" %}，然后{% if recommendIndex > 5 %}<span>热门推荐</span>{% endif %}。问：我新建了一个名为“服务”的内容模型，也添加了内容，但前端页面访问时显示空白或报错，该如何排查？ 答：这通常是由于缺少对应的模型级模板文件所致。当您新建内容模型后，需要为其创建默认的详情页和列表页模板文件。例如，如果您的模型表名为
service，请在template目录下创建service/detail.html和service/list.html文件，并确保这些文件中包含了模型内容的基本调用标签。如果仍然有问题，检查后台“伪静态规则”中是否正确配置了新模型的URL规则。