模块化模板
依托模块结构构建的模板工程,开发方式简单,每个模块均可使用自己特有的模板,出错时定位快捷。
适用:对模块(频道栏目)有不同模板要求的开发者,例如大型综合网站及多模块系统。
储存路径:
app/modules/xxx/skin/front
app/modules/xxx/skin/admin
(xxx 代表模块标志)
混合开发:支持(模板与代码可以混合)
整站模板工程
TEMPADMIN
比较系统的模板开发方式,所有模板及资源储存在同一个模板目录下(template),只需根据模板引擎的指令进行机械响应。
适用:模板要求比较单一的开发者,例如企业网站及博客系统。
储存路径:
app/template/xxx/skin/<模块>/front
app/template/xxx/skin/<模块>/admin
(xxx 代表模板标志,模板工程只覆盖它带 skin/<模块> 的模块)
混合开发:不支持(模板与代码绝对分离)
模板工程文件结构
┌─╌╌assets 静态资源
├─╌╌move 安装时覆盖的文件
├─╌╌skin 模板目录
│.........├─╌╌ut-frame 公共模块
│.........│.........├─admin 开发端模板
│.........│.........├─cache 缓存
│.........│.........│...├─admin
│.........│.........│...└─front
│.........│.........└─front 客户端模板
│.........└─其他模块
└─╌╌usualtool.config 配置引导
引用模板静态资源示例路径为:/assets/template/模板名/xxx.css
整站模板工程usualtool.config配置文件结构
| 字段 | 必填 | 说明与取值 |
|---|---|---|
id |
必填 | 模板英文名称/标志,全局唯一。建议小写字母 + 中划线,与模板目录名保持一致(如 b-concise)。 |
lang |
必填 | 模板适用语言。值为中文、英文及多国语言(多语言用逗号分隔,如 中文,英文)。 |
title |
必填 | 模板中文名称,展示在后台模板列表中(如 简洁博客模板)。 |
type |
必填 |
模板类别,默认 1: 1 — 官方模板; 2 — 私有模板。 对应 XML 标签为 <type>。
|
cate |
必填 | 收费类型,取值 Free(免费)/Sale(收费)。对应 XML 标签为 <cate>。 |
price |
必填 | 价格。免费填 0.00(保留两位小数)。 |
auther |
必填 | 作者。注明作者信息(名字/邮箱/站点),有助于开发者快速联络到你。无作者时填 NULL。 |
ver |
必填 | 版本号,建议语义化版本,便于后续升级比对(如 2.0)。 |
description |
可选 | 介绍说明:模板风格、适用站点类型、依赖条件、注意事项等。无内容时填 NULL。 |
module |
按需 |
模板依赖模块列表。模板需要哪些模块才能正常渲染就填哪些,多个用半角逗号分隔(如 article)。注意:模板工程只覆盖它自己带 skin/ 的模块,框架不做回落——未覆盖的模块在工程化模式下无法渲染,所以依赖列表要与 skin/<模块>/ 实际目录一致。
|
installsql |
按需 |
安装模板时所关联并需要运行的数据库 SQL。例如模板依赖搜索功能时插入 cms_search_set 配置。必须包在 <![CDATA[ ... ]]> 内;没有则保持原样(默认 0)。
|
uninstallsql |
按需 |
通过系统卸载删除模板时需要运行的数据库 SQL,用于清理 installsql 写入的数据。 没有则保持原样(默认 0)。建议只回滚本模板自己写入的数据,并提醒用户先备份。
|