模块文件结构如下:
┌─lang 模块语言包
├─assets 模块静态资源
├─cache 缓存
├─front 前端控制
├─admin 后端控制
├─skin 模板视图
├─model 模型
├─controller 独立控制器
├─route.php 路由映射配置
└─usualtool.config 配置文件
引用模块静态资源示例路径为:/assets/modules/模块名/xxx.css
其中:
Lang语言包是标准的JSON文件其格式为:
{
"s": {
"language": "zh",
"charset": "utf-8",
"speak": "中文简体",
"web": "UT"
},
"l": {"参数":"翻译"}
}
文件名以标准国别为准。
admin、front存放后端与前端的动态脚本。
cache文件夹必须存在,给予写入权限,将自动写入缓存文件。
skin为模板目录,包含front、admin前端与后端的模板文件,其名称与动态脚本文件名称对应,后缀为.cms
usualtool.config为配置文件,格式如下:
其中:
id,模块标志,由英文组成,独一无二。
modtype,模块类别,1表示官网且仅能从官网列表安装,2表示自用,可以从本地安装,不会出现在官网列表中
auther,模块作者
title,属于modname模块名称的冗余字段,可与modname保持一致
modname,模块名称
ver,版本号
description,模块详细说明
itemid,模块所属种类,1表示内容模块,2表示互联模块,3表示交互模块
ordernum,模块排序,数字
composer,模块依赖,该节点可选,不可轻易在ut-frame模块使用。若不安装指定依赖,模块将提示无法运行
modurl,模块后端访问地址
befoitem,模块前端文件列表,编写规则url,url......文件(带后缀)半角逗号分隔,其中如果需要在安装时复制目录到指定位置,使用dir:images,表示将模块下images目录复制到根目录images
backitem,模块后端文件列表,编写规则title:url,title:url......名称半角冒号文件(带后缀),半角逗号分隔
installsql,安装数据表SQL代码,如果插件需要进行数据表的添加,请将SQL代码写入,否则保持原样
uninstallsql,卸载数据表SQL代码,引导用户卸载插件后卸载数据表的操作,如没有请保持原样