在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作为后缀。