需要用到的目录:theme

目录规范

主题文件存储于theme目录下,每一个子目录就是一个主题.进行主题的开发需要遵循以下目录规范

  1. 主题必须有一个config.php作为配置文件,用来填写各类主题配置,具体请查看配置文件的相关内容
  2. 必须有一个index目录且存在index.php作为首页的设计
  3. 主题可以存在download目录、user目录等来定义这些功能的样式,但必须存在这些目录下必须有index.php
  4. 主题的静态资源只能存储于模板目录中,不能存储在其他目录中

配置文件

对于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仅做备份)
步骤:

  1. fork项目
  2. 将开发的主题添加至你的仓库中的theme目录下
  3. 提交pull request,标题为“主题提交+主题名称”,说明中请尽量给出相应的测试站
  4. 等待开发者审核并添加至主仓库
作者:Ivan Hanloth  创建时间:2022-10-03 10:27
最后编辑:Ivan Hanloth  更新时间:2022-10-04 19:16