如何在AnQiCMS中为特定分类或单页面应用独立的模板文件？
📅
👁️ 72
在AnQiCMS中，为了让您的网站更具个性和灵活性，您可以为特定的内容分类、单页面甚至是单篇文章应用独立的模板文件。这种能力让您能够针对不同的内容类型或重要页面，设计专属的视觉风格和功能布局，极大地提升了网站的定制化程度。AnQiCMS提供了两种主要方式来实现这一目标：一种是依靠预设的命名约定进行自动匹配，另一种则是在后台手动指定模板文件。
1. 约定优先的自动匹配
AnQiCMS设计了一套智能的模板匹配机制。这意味着，只要您的模板文件遵循特定的命名规则，系统在渲染页面时就能自动识别并使用它们，省去了您在后台进行额外配置的步骤。这种方式特别适合那些结构化、数量较多且有规律的个性化页面。
具体来说，AnQiCMS支持以下几种约定：
- 针对特定分类的列表页： 如果您希望某个分类下的内容列表页（例如，分类ID为
10的文章分类）拥有独特的布局样式，您可以在当前主题模板文件夹下创建名为{模型table}/list-{分类ID}.html的文件。举个例子，如果您的文章模型对应的表格名称是article，而您想为ID为10的分类创建一个独立列表模板，那么您需要创建一个名为article/list-10.html的文件。当用户访问这个分类的列表页时，系统将自动调用这个模板。 - 针对特定文章或产品的详情页： 同样地，如果您希望某篇特定文章或产品（例如，ID为
5的文章）展示独一无二的详情页样式，您可以创建名为{模型table}/{文档ID}.html的文件。例如，对于ID为5的文章，您可以创建article/5.html文件。当这篇特定文章被访问时，这个模板就会被启用。 - 针对特定单页面的详情页： 对于您的网站中一些重要的单页面（例如，ID为
2的“关于我们”页面），您可以为其创建名为page/{单页面ID}.html的文件，例如page/2.html。系统在访问该单页面时，会自动应用此模板。
这些遵循命名约定的模板文件，都需要放置在您当前激活的主题模板文件夹内（通常是/template/您的主题名/）。
2. 后台灵活指定模板文件
除了自动匹配的便捷，AnQiCMS也允许您在后台手动为特定内容指定模板文件。这种方式提供了更高的灵活性，尤其适用于您希望使用自定义命名，或者需要为通过别名（URL token）访问的内容应用特定模板的场景。
为分类指定独立模板
如果您需要为某个分类设置一个自定义模板，例如一个特殊的下载分类或者一个新闻分类：
- 首先，登录AnQiCMS后台管理界面，导航到“内容管理”菜单，选择“文档分类”。
- 在分类列表中，找到您想要修改的分类，点击“编辑”，或者在新增分类时进行设置。
- 在分类编辑页面的“其他参数”部分，您会找到一个名为“分类模板”的字段。在这里，您可以输入您自定义的模板文件名，例如
download.html或category-news.html。 - 如果这个分类下的所有子分类也需要沿用这个模板，记得勾选“是否应用到子分类”选项。
- 另外，如果您希望这个分类下的文章详情页都使用同一个自定义模板，可以在“文档模板”字段中输入相应的模板文件名。
为单页面指定独立模板
对于“关于我们”、“联系我们”等单页面，您也可以为其指定专属的模板：
- 在后台，前往“页面资源”菜单，选择“页面管理”。
- 编辑或创建单页面时，在页面的设置中找到“单页面模板”字段。
- 在这里填入您为该单页面准备好的模板文件名，比如
about-us.html。文档中也提到，您甚至可以根据单页面的别名（如about）来命名模板文件为page/about.html，然后在后台的“单页面模板”字段中填写about.html（系统会智能识别page/前缀）。
为特定文章或产品指定独立模板
对于某些特别重要的文章或产品，即使它们属于同一个分类，您也可以让它们拥有独立的详情页布局：
- 在“内容管理”菜单下，进入“文档管理”或“产品管理”，找到并编辑您想要设置的文章或产品。
- 在编辑页面的“其他参数”区域，您会找到一个“文档模板”字段。
- 在这里输入您为这篇特定内容设计的模板文件名，比如
product-special-offer.html。
**实践与注意事项
- 模板文件存放位置： 无论是自动匹配还是手动指定，所有自定义的模板文件都必须放置在您当前激活的AnQiCMS主题文件夹内。例如，如果您的主题名为
default，那么category-news.html文件应该位于/template/default/category-news.html。 - 文件后缀： AnQiCMS的模板文件统一使用
.html作为后缀。