emlog模板开发基础2022最新指南

emlog模板的开发基础指南,如果想要开发emlog的模板,你必须知道那些开发内容呢？下面将介绍分析emlog5下的模板基本结构以及基本变量、函数的作用。
首先我们用该知道emlog的模板是位于根目录content\templates\文件夹下,每个模板都是一个单独的文件夹,文件夹以模板名字命名.通过后台上传安装的模板都保存在这个目录下.
模板内容主要部分：

1. images文件夹：存放模板所需图片
2. echo_log.php：显示日志内容
3. footer.php：页面底部
4. header.php：页面头部
5. log_list.php：显示日志列表内容
6. main.css：模板的css文件
7. module.php：模板公共代码,包含侧边widgets、评论、引用、编辑等,该文件是模板最核心的模块
8. page.php：自定义的页面内容的模板
9. preview.jpg：在后台模板选择界面显示的模板预览图,300×225 jpg格式
10. side.php：模板侧边栏文件,如制作单栏模板则该文件不是必须的
11. t.php：显示emlog系统自带的微博（微语）内容
12. 404.php 自定义404页面未找到时的报错页面

在一般的emlog模板开发中,以上提及的部分中echo_log.php、log_list.php、module.php、page.php、 t.php、header.php以及preview.jpg是不可或缺的,一旦缺省,模板将无法运行.此外的side.php、footer.php、 main.css、images文件夹等,只需要对模板代码做小部分更改,那么它们都是可以改名、移动、甚至删除的.
公共代码分析:
通过预览整个模板中的各个文件,你会发现以下代码同时存在于多个文件中,这些代码分别有以下用途：

1. if(!defined(‘EMLOG_ROOT’)) {exit(‘error!’);}

此行代码存在于模板目录下的每个php文件起始部分(事实上为了安全起见,该行代码也在admin目录下的几乎所有php文件起始部分存在),其作用是防 止代码所在的php脚本被直接访问执行

1. require_once View::getView(‘side’); require_once View::getView(‘footer’);

这两行代码存在于log_list.php、echo_log.php、page.php、t.php里面,其作用是调用模板文件夹下的side.php 和footer.php的代码到当前文件的当前位置

1. View::getView(‘文件名’,‘文件后缀’)

View是emlog的模板视图控制器,将 返回当前模板安装路径下对应的文件.getView函数的第二个参数为缺省参数,在不传入值的情况下,将默认作为.php文件后缀返回文件路径.
header.php文件
开头注释内容是模板信息,该信息显示在模板选择界面

1. Template Name:模板名称
2. Description:模板介绍描述
3. Author:模板作者Author
4. Url:作者或模板发布的URL
5. Sidebar Amount:标记该模板有几个侧边栏,一般为1,有些模板有两个侧边栏则标记2.这样可以在后台widgets里识别管理

之后是具体代码部分

1. if(!defined(‘EMLOG_ROOT’)) {exit(‘error!’);}

该行代码同样存在于其它模板文件中,为防止该文件被直接执行

1. require_once View::getView(‘module’);

加载模板公共代码

1. $site_title 站点标题
2. $site_key 关键字
3. $site_description 输出博客设置的摘要
4. BLOG_URL 博客首页的URL
5. TEMPLATE_URL 模板文件夹的URL,用于加载模板内的css、js及其他内容
6. BLOG_URL.Option::get(‘topimg’) 这句可以无视,因为只默认模板可以自定义banner,其它模板没这功能

判断当前是否首页,是则给导航加current类,用于表现当前位置

1. <?php echo $curpage == CURPAGE_HOME ? ‘current’ : ‘common’;?>

如后台设置在前台显示碎语,则输出…….中的内容

1. <?php echo $curpage == CURPAGE_HOME ? ‘current’ : ‘common’;?>

判断当前URL是否为碎语并选择加类名

1. <?php echo $curpage == CURPAGE_TW ? ‘current’ : ‘common’;?>

输出自定义页面的链接

1. <?php foreach ($navibar as $key ⇒ $val):?>…….<?php endforeach;?>

footer.php文件

1. Option::EMLOG_VERSION 获得版本号
2. $icp 获得后台设置的ICP备案号
3. <?php doAction(‘index_footer’); ?> 页脚底部挂载点加入

log_list.php文件

1. <?php doAction(‘index_loglist_top’); ?>
2. 页脚底部挂载点加入
3. $value[‘logid’] 该变量为当前日志的id
4. <?php topflg($value[‘top’]); ?>
5. 显示置顶标记,该函数位于模板module.php内
6. <?php echo $value[‘log_url’]; ?>
7. 输出日志URL
8. <?php echo $value[‘log_title’]; ?>
9. 输出日志标题
10. <?php blog_author($value[‘author’]); ?>
11. 输出日志的作者,该函数位于模板module.php内
12. <?php echo gmdate(‘Y-n-j G:i l’, $value[‘date’]); ?>
13. 输出日志发布时间,参数’Y-n-j G:i l’用于定义日期格式
14. <?php blog_sort($value[‘logid’]); ?>
15. 输出日志所属的分类,该函数位于模板module.php内
16. <?php editflg($value[‘logid’],$value[‘author’]); ?>
17. 当管理员或作者登陆时显示“编辑”链接,该函数位于模板module.php内
18. <?php echo $value[‘log_description’]; ?>
19. 输出日志摘要（没有摘要则输出全文）.
20. <?php blog_att($value[‘logid’]); ?>
21. 如日志有附件则输出附件,该函数位于模板module.php内
22. <?php blog_tag($value[‘logid’]); ?>
23. 输出日志的标签,该函数位于模板module.php内.
24. <?php echo $value[‘comnum’]; ?>
25. 输出当前日志的评论数
26. <?php echo $value[‘tbcount’]; ?>
27. 输出当前日志的引用量
28. <?php echo $value[‘views’]; ?>
29. 输出当前日志的浏览量
30. <?php echo $page_url;?>
31. 显示当前列表页的翻页功能
32. <?php include View::getView(‘side’); include View::getView(‘footer’); ?>
33. 加入侧边栏及加入页脚

echo_log.php文件
该文件功能函数与列表页一致,但参数有区别,注意区分. $logid 该变量为当前日志的id

1. <?php topflg($top); ?> 显示置顶标记,该函数位于模板module.php内.
2. <?php echo $log_title; ?> 输出日志标题.
3. <?php blog_author($author); ?> 输出日志的作者,该函数位于模板module.php内.
4. <?php echo gmdate(‘Y-n-j G:i l’, $date); ?> 输出日志发布时间,参数’Y-n-j G:i l’用于定义日期格式.
5. <?php blog_sort($logid); ?>
6. 输出日志所属的分类,该函数位于模板module.php内
7. <?php editflg($logid,$author); ?>
8. 当管理员或作者登陆时显示“编辑”链接,该函数位于模板module.php内
9. <?php echo $log_content; ?>
10. 输出日志全文内容
11. <?php blog_att($logid); ?>
12. 如日志有附件则输出附件,该函数位于模板module.php内
13. <?php blog_tag($logid); ?>
14. 输出日志的标签,该函数位于模板module.php内
15. <?php echo $comnum; ?>
16. 日志页显示评论数
17. <?php echo $tbcount; ?>
18. 日志页显示引用数
19. <?php echo $views; ?>
20. 日志页显示浏览量
21. <?php doAction(‘log_related’, $logData); ?>
22. 相关日志的挂载点,与3.x版本不同,4.0带第二参数
23. <?php neighbor_log($neighborLog); ?>
24. 输出邻近,就是上一篇及下一篇,该函数位于模板module.php内
25. <?php blog_trackback($tb, $tb_url, $allow_tb); ?>
26. 输出该日志被引用的信息列表,与3.x不同注意区分
27. <?php blog_comments($comments); ?>
28. 输出该日志评论列表,与3.x不同注意区分
29. <?php blog_comments_post($logid,$ckname,$ckmail,$ckurl,$verifyCode,$allow_remark); ?>
30. 输出发表评论框,与3.x不同注意区分

page.php文件
该文件写法与echo_log.php类似,请参照上方描述
t.php文件
与之前相同的内容不再重复

1. <?php echo $avatar; ?> 输出头像
2. <?php echo $author; ?> 输出作者名
3. <?php echo $val[‘t’];?> 输出碎语内容
4. <?php echo DYNAMIC_BLOGURL; ?> 根据当前url输出博客网址,主要用于js,解决跨域问题
5. <?php echo $tid;?> 输出碎语所在数据库中的id号
6. <?php echo $val[‘date’];?> 发布碎语的时间
7. $reply_code ：其值为‘n’或‘y’,后台设置是否启用碎语回复验证码
8. <?php echo $rcode; ?> 输出验证码

side.php文件
侧边栏,主要负责根据后台widgets设置信息输出侧边栏内容.建议该文件内代码保持不变.
module.php文件
模板公共代码,包含侧边widgets、评论、引用、编辑等. 该文件由若干函数组成,被博客前台文件调用,可在内自定义函数实现更多功能. 如在自定义函数内调用emlog缓存时,假设读取user缓存信息,则形如： global $CACHE; $user_cache = $CACHE→readCache(‘user’); 如需要操作数据库,则形如： $DB = MySql::getInstance(); $res = $DB→query($sql); 以上两点与3.x不同,请注意区分
404.php文件
用于自定义404页面的模板.可以自行设置。
最后注意：
前台模板部分挂载点一览

1. doAction(‘index_footer’); //页脚底部挂载点
2. doAction(‘index_loglist_top’); //首页日志列表顶部挂载点
3. doAction(‘log_related’, $logData); //相关日志挂载点
4. doAction(‘diff_side’); //侧边栏挂载点