在使用AnQiCMS搭建网站的过程中，我们经常会遇到这样的需求：希望某个特定的分类列表页，或者某篇独特的文章详情页，拥有与众不同的布局和样式，而不是沿用全局统一的默认模板。AnQiCMS作为一个专注于灵活性和可定制性的内容管理系统，在这方面提供了非常便捷和强大的解决方案，让我们能够轻松实现这种精细化的模板调用。
实现分类或文章详情页的自定义模板调用，AnQiCMS主要提供了两种主要方式：一种是遵循特定的命名约定，系统会自动识别并应用；另一种则是在后台内容编辑时，手动指定要使用的模板文件。这两种方式都各有优势，可以根据实际场景灵活选择。
一、通过约定命名实现模板的自动匹配
AnQiCMS深知效率的重要性，因此引入了一套智能的模板命名约定。只要你按照这些规则创建模板文件，系统就能在访问对应页面时，无需额外配置便会自动调用。这种方式特别适合那些你明确知道会长期使用特定模板的页面，一次配置，一劳永逸。
具体来说：
对于文章或产品详情页： 如果你希望某篇ID为
10的文章，或者某个产品模型下ID为20的产品详情页拥有独立模板，你可以分别在对应模型（例如：文章模型的表名可能是article，产品模型的表名可能是product）的模板文件夹下创建以ID命名的模板文件。 例如：- 针对ID为
10的文章：在你的主题模板目录中创建article/10.html。 - 针对ID为
20的产品：在你的主题模板目录中创建product/20.html。 当用户访问这些文章或产品的详情页时，系统会优先查找并应用这些特定ID的模板文件。
- 针对ID为
对于分类列表页： 如果你希望某个ID为
5的文章分类列表页，或者某个ID为8的产品分类列表页有独特的展示，可以在对应模型的模板文件夹下创建以list-分类ID命名的模板文件。 例如：- 针对ID为
5的文章分类：在你的主题模板目录中创建article/list-5.html。 - 针对ID为
8的产品分类：在你的主题模板目录中创建product/list-8.html。 这样一来，当用户访问这些分类的列表页时，系统便会自动加载这些定制的模板。
- 针对ID为
对于单页面： 单页面（如“关于我们”、“联系我们”）的模板定制也同样便捷。如果你有一个ID为
12的单页面，你可以在主题模板目录中创建page/12.html。系统在访问该单页面时，会直接调用此模板。
这些约定命名的模板文件都应放置在你的当前主题模板的根目录下的对应子目录中（例如：/template/你的主题目录/article/10.html），以确保系统能够正确识别。
二、在后台手动指定模板文件
除了自动匹配，AnQiCMS还提供了在后台界面直接为单个文章、分类或单页面指定模板的灵活选项。这种方式给予了我们更精细的控制，特别适用于那些不希望依赖ID命名，或者需要使用更具描述性的模板名称的场景。
为文章或产品详情页指定模板： 当你需要给某个特定文章或产品设置独立模板时，可以进入AnQiCMS后台，导航到“内容管理”下的“文档管理”，找到并编辑对应的文章或产品。在编辑页面的“其他参数”部分，会有一个“文档模板”字段。你可以在这里填写你预先创建好的模板文件名，例如
download.html或者special_product_detail.html。 请务必确保这个自定义模板文件（例如download.html）已经存在于你当前主题模板的根目录下。如果文件不存在，页面将无法正常打开。为分类列表页指定模板： 如果你想为某个分类列表页定制模板，可以进入后台“内容管理”下的“文档分类”，编辑对应的分类。在“其他参数”中，你会找到一个“分类模板”字段。在这里填写你想要的模板文件名，比如
special_category_list.html。 值得一提的是，分类模板还提供了一个“是否应用到子分类”的选项。勾选此项，该分类下的所有子分类将自动继承并使用你指定的这个自定义模板，无需逐一设置，大大提升了管理效率。为单页面指定模板： 对于单页面的模板定制，同样是在后台操作。进入“页面资源”下的“页面管理”，编辑相应的单页面。在页面编辑详情中，你会看到一个“单页面模板”字段。你可以在此填写自定义的模板文件名，例如为“关于我们”页面指定
page/about.html。
无论是通过约定命名还是后台手动指定，所有自定义的模板文件都必须是.html后缀，并且位于你当前使用主题的/template/你的主题目录/下。模板中用到的样式、JS脚本和图片等静态资源，通常存放在/public/static/目录中，并通过{% system with name="TemplateUrl" %}标签来引用路径，确保资源的正确加载。
通过这些灵活的模板调用机制，AnQiCMS让我们能够根据内容营销、SEO优化和用户体验的各种需求，为网站的每一个角落量身定制独特的展示方式，真正实现内容呈现的自由和个性化。
常见问题 (FAQ)
Q1: 自定义模板文件命名时，如果多个文章或分类ID都指向同一个模板文件，会发生冲突吗？
A1: 不会。系统会按照优先级进行匹配。如果你为某个文章ID 10 创建了 article/10.html，同时又在后台为该文章手动指定了 custom_article.html，那么手动指定的模板会优先被调用。约定命名是为了方便批量或不需后台干预的场景，而后台手动指定则提供了更精细的控制。
Q2: 我在后台指定了自定义模板，但前台页面没有变化，是什么原因？ A2: 最常见的原因是自定义模板文件本身不存在或者路径不正确。请仔细检查你的主题模板目录下是否存在你所指定的模板文件，并且文件名、路径与后台填写的是否完全一致。此外，如果页面有缓存，可能需要清除AnQiCMS的系统缓存才能看到更新效果。
Q3: 如果我自定义了分类模板并启用了“应用到子分类”选项，但是某个子分类我希望它有自己的独特模板，可以覆盖吗？ A3: 是的，可以覆盖。虽然父分类设置的“应用到子分类”会使子分类默认继承该模板，但你仍然可以单独编辑任何一个子分类，并在其“分类模板”字段中指定一个更具体的模板文件。子分类的独立设置会覆盖父分类的继承设置，实现更灵活的层级控制。