开发方式

代码开发

可视化开发

开发资源

代码仓库

AI助手

衍生系统

UTCms

UTForum

文档有错误?
发信:usualtool@qq.com

定位至目录

模板开发方式
M

模块化模板

默认方式

依托模块结构构建的模板工程,开发方式简单,每个模块均可使用自己特有的模板,出错时定位快捷。

适用:对模块(频道栏目)有不同模板要求的开发者,例如大型综合网站及多模块系统。

储存路径:
app/modules/xxx/skin/front
app/modules/xxx/skin/admin
(xxx 代表模块标志)

混合开发:支持(模板与代码可以混合)

T

整站模板工程

TEMPFRONT
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)。建议只回滚本模板自己写入的数据,并提醒用户先备份。

始于2018年,UT框架版权归原作者所有
开放、包容、发展。 工单 | 团队 | 蜀ICP备2024067013号