需要用到的目录:theme
目录规范
主题文件存储于theme目录下,每一个子目录就是一个主题.进行主题的开发需要遵循以下目录规范
- 主题必须有一个config.php作为配置文件,用来填写各类主题配置,具体请查看配置文件的相关内容
- 必须有一个index目录且存在index.php作为首页的设计
- 主题可以存在download目录、user目录等来定义这些功能的样式,但必须存在这些目录下必须有index.php
- 主题的静态资源只能存储于模板目录中,不能存储在其他目录中
配置文件
对于v3.0.0版本,其模板配置文件config.php文件如下:
<?php
$theme_config=array(
/*
署名类配置
*/
"name"=>"",//模板名称
"designer_name"=>"",//设计者名称
"preview"=>"",//模板预览图地址
/*
设计类配置
*/
"head"=>'',//需要引入的头部(可包含css/js等必须文件,可以覆盖template里自带的css,可被用户自定义的css覆盖)
"main_css"=>"",//主类css(多个用空格隔开),主要用于按钮、边框等
"some_css"=>"",//副类css(多个用空格隔开),主要用于图标、字体等
"main_color"=>"",//主色彩
"some_color"=>""//副色彩
)
?>其中主类css主要用于按钮、进度条、背景等颜色的配置,副类css主要用于图标、文字颜色的配置,即主类css应该有对于background的配置,副类css应该有对于font的配置。
后续模板将在后台有单独的选择页面。为向上兼容,请尽量填写好署名类配置。
功能调用
Easy-Send的主题开发主要针对前端的视觉设计而不用过多考虑功能设计,为此我们对功能进行模块化封装并提供直接调用方法
统一调用格式:<?php tmp_功能名称_样式名称() ?>
例如<?php tem_require_header()?>
| 功能分类 | 调用方法 | 对应样式 | 备注 |
|---|---|---|---|
| 配置模块 | tem_require_head() |
无 | 必须引用,加载各类必备文件。内含<html>标签和<head></head>标签。应在模板最开始引用 |
| 配置模块 | tem_require_header() |
无 | 可选引用,加载管理员自定义的头部,应放在<body></body>标签之间 |
| 配置模块 | tem_require_footer() |
无 | 可选引用,加载管理员自定义的尾部,可放在<footer></footer>标签之间 |
| 数据获取 | tem_get_default() |
默认 | 无 |
| 文件上传 | tem_file_drag_box() |
拖拽上传 | 无 |
| 文件上传 | tem_file_drag_whole() |
拖拽上传(全屏) | 暂未生效,正在开发中 |
| 文本上传 | tem_text_textarea() |
文本域 | 无 |
| 文件直传 | tem_room_default() |
默认 | 无 |
| 文件下载 | tem_download_big_showpercent() |
显示百分比,粗进度条 | 无 |
贡献方式
可以将开发好的主题通过github的pull request进行提交(请勿通过gitee提交,gitee仅做备份)
步骤:
- fork项目
- 将开发的主题添加至你的仓库中的theme目录下
- 提交pull request,标题为“主题提交+主题名称”,说明中请尽量给出相应的测试站
- 等待开发者审核并添加至主仓库
作者:Ivan Hanloth 创建时间:2022-10-03 10:27
最后编辑:Ivan Hanloth 更新时间:2022-10-04 19:16
最后编辑:Ivan Hanloth 更新时间:2022-10-04 19:16