安企cms模板开发指南

在开始开发新模板时，需要先熟悉安企的模板构成。

常见操作流程如下：

新建文件夹，改名为将要开发的模板名字，在其下新建static和template文件夹，用以存放css、图片、js代码和html模板文件。

在template文件夹下新建config.json(用来说明模板的一些信息)空白文件

config.json文件内容如下：

{

"name": "默认模板",

"package": "default",

"version": "1.0",

"description": "系统默认模板",

"author": "kandaoni.com",

"homepage": "https://www.kandaoni.com",

"created": "2022-05-10 22:29:00",

"template_type": 0.

"status": 0.

}

config.json 的字段都是选填的，如果都不填，系统将会根据实际情况生成，其中的字段说明：

name 模板名称，按照实际情况来取名

package 模板文件夹，仅支持英文字母和数字，请填写你的模板文件夹名称。

version 模板的版本，自定义

description 模板的介绍

author 模板作者

homepage 模板作者的网站

created 模板创建时间，格式为：2022-05-10 22:29:00

template_type 模板类型，可选值为：0 自适应;1 代码适配;2 电脑+手机

status 模板使用状态，可选值为：0 未启用，1 使用中。所有的模板中，只能有一套模板的 status 值 为 1

模板目录和文件支持2种模式

文件夹组织模式

公共代码 bash.html 比如页头、页脚等每个页面都继承的部分，则放在这里，供引用。

代码片段目录 partial/ 比如侧边栏、面包屑等代码片段，则存放在这里

首页 index/index.html

模型首页 {模型table}/index.html

文档详情页 {模型table}/detail.html {模型table}/detail-{文档ID}.html

文档列表页 {模型table}/list.html {模型table}/list-{文档分类ID}.html

评论列表页 comment/list.html

在线留言页 guestbook/index.html

单页面详情页 page/detail.html page/detail-{单页ID}.html

搜索页 search/index.html

标签首页 tag/index.html

标签文档列表页 tag/list.html

404错误页 errors/404.html

500错误页 errors/500.html

站点关闭提示页 errors/close.html

手机端模板目录 mobile/ 手机端模板目录里的目录结构和模板文件跟上面一致，重复一遍即可。

扁平化文件组织模式

公共代码 bash.html 比如页头、页脚等每个页面都继承的部分，则放在这里，供引用。

代码片段目录 partial/ 比如侧边栏、面包屑等代码片段，则存放在这里

首页 index.html

模型首页 {模型table}_index.html

文档详情页 {模型table}_detail.html

文档列表页 {模型table}_list.html

评论列表页 comment_list.html

在线留言页 guestbook.html

单页面详情页 page.html page-{单页ID}.html

搜索页 search.html

标签首页 tag_index.html

标签文档列表页 tag_list.html

404错误页 errors_404.html

500错误页 errors_500.html

站点关闭提示页 errors_close.html

手机端模板目录 mobile/ 手机端模板目录里的目录结构和模板文件跟上面一致，重复一遍即可。

同时，部分模板还支持自定义名称，如文档详情、分类页、单页面，可以增加其他文件名，来处理不同的分类、页面需要不同的模板的情况。如需要对 关于我们 这个单页，采用独立的模板，则可以命名模板为 page/about.html，并在后台创建一个 调用自定义模板为 page/about.html 的关于我们页面即可。

AnqiCMS 的模板，使用 .html 作为模板文件后缀，并存放在 /template 模板文件夹中，模板用到的样式、js脚本、图片等静态资源，则单独存放在 /public/static/ 目录。

模板文件的使用类似 Django 模板引擎的标签标记，变量则使用双花括号来定义，如 {{变量}}。条件判断、循环控制等标签，使用单花括号和百分号来定义，并且需要用结束标签来结束，标签成对出现，如 {% if archive.Id == 10 %}这是文档ID为10的文档{% endif %}。

变量名采用驼峰命名法则，每个单词首字母大写，部分特殊规定的除外，如 {archive.Id}、{archive.Title}。

模板文件统一编码为UTF8编码，如果是其他编码，则会导致页面乱码，无法正常显示，如果是windows用户编辑模板文件的时候，请存储成UTF-8格式编码的模板文件。

模板支持的类型有：自适应模板类型、代码适配模板类型、PC+手机端模板类型。

模板支持单独的移动端模板定义，移动端模板存放在 mobile 目录，选择 代码适配模式、PC+手机端模式 的模板的时候，需要创建 mobile 模板。

模板支持一些默认的自定义名称，只要存在这些自定义的模板文件，则不需要单独在后台设置模板，就能自动应用该模板。

已支持的模板名称情况：

文档默认自定义模板 名称格式是 {模型table}/{文档id}.html

文档列表默认自定义模板 名称格式是 {模型table}/list-{分类id}.html

单页面默认自定义模板 名称格式是 page/{单页面id}.html