安企CMS为网站内容管理提供了极大的灵活性，其中分类页面的显示样式定制就是一项非常实用的功能。通过为不同的分类设置自定义模板，您可以轻松地让新闻、产品、案例等不同类型的分类页面呈现出独特的设计和内容布局，从而更好地满足用户浏览需求和品牌展示策略。

为什么需要自定义分类模板？

默认情况下，安企CMS会为所有分类使用一套通用的列表模板（通常是{模型table}/list.html），这可能导致所有分类页面的视觉效果千篇一律。然而，不同的分类往往承载着不同的内容属性和营销目标。例如，一个“公司新闻”分类可能需要简洁的标题列表和发布日期，而一个“产品展示”分类则可能需要大图、价格和更详细的产品参数筛选功能。通过自定义模板，您可以打破这种统一性，为每个分类量身定制专属的展示界面，从而：

  • 提升用户体验： 根据内容类型提供最合适的布局和信息展示方式，让用户更快找到所需信息。
  • 强化品牌形象： 为特定分类设计独特风格，更好地传达品牌特色和专业度。
  • 优化内容营销： 突出关键信息，引导用户行为，提升转化率。
  • 实现个性化展示： 即使是同一内容模型下的不同分类，也能拥有完全不同的视觉呈现。

安企CMS正是凭借其灵活的内容模型和易扩展的模板机制，使得这样的定制成为可能。

安企CMS自定义分类模板的核心机制

安企CMS提供两种主要方式来实现分类页面的自定义模板：

  1. 遵循默认命名约定： 安企CMS支持一些默认的模板文件命名规则。如果您创建的模板文件符合这些规则，系统会自动识别并应用，无需在后台进行额外设置。

    • 对于特定分类，您可以创建一个名为 {模型table}/list-{分类ID}.html 的模板文件。例如，如果您有一个文章模型的分类ID为10，您可以创建 article/list-10.html。
    • 对于某个内容模型下的所有分类（除非被更具体的分类模板覆盖），您可以创建一个名为 {模型table}/list.html 的模板文件来作为该模型分类页面的默认模板。

  2. 通过后台界面指定模板： 这是最常用也最灵活的方式。您可以在后台的分类编辑页面，明确指定该分类使用哪个自定义模板文件。这种方式的优先级高于默认命名约定，即如果您为某个分类指定了自定义模板，即使存在符合命名约定的模板文件，系统也会优先使用您手动指定的模板。

接下来，我们将重点讲解如何在后台指定自定义模板的具体操作步骤。

具体操作步骤

为安企CMS中的分类设置自定义模板，以改变其页面显示样式，主要分为以下几个步骤：

步骤一：准备自定义模板文件

首先，您需要在当前的模板主题文件夹中创建或修改一个模板文件。

  1. 找到模板目录： 登录您的服务器文件系统，定位到安企CMS的安装目录下的 /template/ 文件夹。在这个文件夹中，您会看到您当前正在使用的模板主题的名称（例如 default）。进入该模板主题文件夹。
  2. 创建模板文件： 在您的模板主题文件夹内，您可以根据内容模型的类型，在对应的子文件夹（如 article、product 等）下创建一个新的 .html 文件，或者直接在根目录创建。例如，如果您想为文章分类定制模板，可以创建 article/custom-article-list.html。给模板文件起一个有意义的名字，方便日后识别。
  3. 编写模板内容：
    • 建议从现有模板开始： 最简单的方式是复制当前模板主题中已有的分类列表模板（例如 article/list.html 或 product/list.html），然后将其内容粘贴到您新创建的 custom-article-list.html 文件中。
    • 运用安企CMS标签： 在模板文件中，您可以根据需要，使用安企CMS提供的各类标签来调用数据，例如：
      • {% archiveList %}：用于获取分类下的文档列表。您可以设置不同的参数来控制显示数量、排序方式等。
      • {% categoryDetail %}：用于获取当前分类的详细信息，如分类标题、描述、Logo图等。
      • {% system %}：获取网站全局设置信息。
      • {% pagination %}：用于生成分页链接。
      • 以及各种条件判断（{% if %}）、循环遍历（{% for %}）等Django模板引擎语法。
    • 设计布局和样式： 在此文件中，您可以自由调整HTML结构，引入CSS样式（通常存放在 /public/static/ 目录中），以实现您想要的页面布局和视觉效果。

步骤二：进入分类管理界面

登录安企CMS后台管理系统，在左侧导航栏中找到并点击 “内容管理”，然后选择 “文档分类”。

步骤三：选择并编辑目标分类

在文档分类列表中，找到您想要应用自定义模板的分类，点击其右侧的 “编辑” 按钮，进入分类编辑页面。

步骤四：指定分类模板

在分类编辑页面的表单中，向下滚动，找到 “其他参数” 部分，展开它。您会看到一个名为 “分类模板” 的字段。

  1. 输入模板文件名： 在“分类模板”字段的输入框中，填入您在 步骤一 中创建的自定义模板文件的相对路径和文件名。请务必填写正确，例如 article/custom-article-list.html。注意： 填写时不需要包含模板主题文件夹的名称，只需要从内容模型文件夹开始的相对路径（如果您的模板文件直接放在article文件夹下）或直接写文件名（如果模板文件就放在模板主题的根目录）。
  2. 考虑子分类继承： 在“分类模板”字段下方，您还会看到一个名为 “是否应用到子分类” 的选项。
    • 如果您希望该分类下的所有子分类（包括多级子分类）都沿用您当前设置的自定义模板，请勾选此选项。
    • 如果您希望子分类保持其默认模板或拥有独立的自定义模板，则不勾选此选项。

步骤五：保存并验证

  1. 保存分类信息： 点击页面底部的 “确定” 按钮，保存您对分类设置的更改。
  2. 清除缓存： 返回后台主页面，点击左侧导航栏的 “更新缓存” 按钮，清理系统缓存，确保模板更改能够立即生效。
  3. 访问前台验证： 打开浏览器，访问您刚刚修改的分类页面（通过点击分类列表中的“查看”链接或直接输入分类URL），检查新的自定义模板是否已成功应用，页面样式和内容布局是否符合您的预期。

通过以上步骤，您就可以为安企CMS中的分类设置专属的自定义模板，实现高度个性化的网站页面展示。

常见问题 (FAQ)

1. 我的自定义模板文件应该放在哪个目录下？ 您的自定义模板文件应放在安企CMS安装目录下的 /template/您的模板主题名称/ 文件夹中。例如，如果您使用的模板主题是 default，且该模板是用于文章模型的分类列表，您可以将其放在 /template/default/article/ 目录下，文件名为 my-custom-category.html。

2. 为什么我设置了分类模板，但前台页面没有任何变化？ 这通常有几个原因：

  • 未清除缓存： 在修改模板或后台设置后，请务必前往后台点击“更新缓存”。
  • 模板文件名或路径错误： 请仔细核