emlog模板结构介绍

  • 首页 > 技术学习
  • 作者:小小的一世
  • 时间: 2017年1月4日 16:49
  • 字数:6505 个
  • 字号:
  • 评论:2 条
  • 浏览:4991 次
  • 百度:百度已收录
  • 分类: 技术学习
  • 时间:2017-1-4 16:49 热度:4991° 评论:2 条 

    模板文件目录说明


    一般来说,一个模板都会包含以下几个部分:


    images文件夹:存放模板所需图片。

    echo_log.php:显示日志内容。

    footer.php:页面底部。

    header.php:页面头部。

    log_list.php:显示日志列表内容。

    main.css:模板的css文件。

    module.php:模板公共代码,包含侧边widgets、评论、引用、编辑等,该文件是模板最核心的模块。

    page.php:自定义的页面内容的模板。

    preview.jpg:在后台模板选择界面显示的模板预览图,300×225 jpg格式。

    side.php:模板侧边栏文件,如制作单栏模板则该文件不是必须的。

    t.php:显示emlog系统自带的微博(碎语)内容。

    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文件夹等,只需要对模板代码做小部分更改,那么它们都是可以改名、移动、甚至删除的。


    下面我们将对以上各模块进行简要分析:


    公共代码分析


    通过预览整个模板中的各个文件,你会发现以下代码同时存在于多个文件中,这些代码分别有以下用途: if(!defined('EMLOG_ROOT')) {exit('error!');} 此行代码存在于模板目录下的每个php文件起始部分(事实上为了安全起见,该行代码也在admin目录下的几乎所有php文件起始部分存在),其作用是防止代码所在的php脚本被直接访问执行。 require_once View::getView('side'); require_once View::getView('footer'); 这两行代码存在于log_list.php、echo_log.php、page.php、t.php里面,其作用是调用模板文件夹下的side.php和footer.php的代码到当前文件的当前位置。View是emlog的模板视图控制器,View::getView('文件名','文件后缀')将返回当前模板安装路径下对应的文件。getView函数的第二个参数为缺省参数,在不传入值的情况下,将默认作为.php文件后缀返回文件路径。


    header.php


    开头注释内容是模板信息,该信息显示在模板选择界面


    Template Name:模板名称

    Description:模板介绍描述

    Author:模板作者

    Author Url:作者或模板发布的URL

    Sidebar Amount:标记该模板有几个侧边栏,一般为1,有些模板有两个侧边栏则标记2。这样可以在后台widgets里识别管理(具体可下载体验官方收录的模板G7)。

    之后是具体代码部分:


    if(!defined('EMLOG_ROOT')) {exit('error!');}


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


    require_once View::getView('module');


    加载模板公共代码.


    * $site_title:站点标题 * $site_key:关键字 * $site_description:输出博客设置的摘要 * BLOG_URL:博客首页的URL,输出形如http://simue.com/blog/ * TEMPLATE_URL:模板文件夹的URL,用于加载模板内的css、js及其他内容,输出形如http://simue.com/blog/content/templates/simue-tuso/ * BLOG_URL.Option::get('topimg'):这句可以无视,因为只默认模板可以自定义banner,其它模板没这功能(卡片语:很没营养的设定,嗯。)


    <?php echo $curpage == CURPAGE_HOME ? 'current' : 'common';?> 判断当前是否首页,是则给导航加current类,用于表现当前位置。


    <?php if($istwitter == 'y'):?>…….<?php endif;?> 如后台设置在前台显示碎语,则输出…….中的内容。


    <?php echo $curpage == CURPAGE_TW ? 'current' : 'common';?> 判断当前URL是否为碎语并选择加类名。


    <?php foreach ($navibar as $key ⇒ $val):?>…….<?php endforeach;?> 输出自定义页面的链接


    footer.php


    Option::EMLOG_VERSION:获得版本号。


    $icp:获得后台设置的ICP备案号。


    <?php doAction('index_footer'); ?> 页脚底部挂载点加入。


    log_list.php


    <?php doAction('index_loglist_top'); ?> 页脚底部挂载点加入。


    $value['logid'] 该变量为当前日志的id


    <?php topflg($value['top']); ?> 显示置顶标记,该函数位于模板module.php内。


    <?php echo $value['log_url']; ?> 输出日志URL


    <?php echo $value['log_title']; ?> 输出日志标题


    <?php blog_author($value['author']); ?>


    输出日志的作者,该函数位于模板module.php内。


    <?php echo gmdate('Y-n-j G:i l', $value['date']); ?>


    输出日志发布时间,参数'Y-n-j G:i l'用于定义日期格式。


    <?php blog_sort($value['logid']); ?>


    输出日志所属的分类,该函数位于模板module.php内。


    <?php editflg($value['logid'],$value['author']); ?>


    当管理员或作者登陆时显示“编辑”链接,该函数位于模板module.php内。


    <?php echo $value['log_description']; ?>


    输出日志摘要(没有摘要则输出全文)。


    <?php blog_att($value['logid']); ?>


    如日志有附件则输出附件,该函数位于模板module.php内。


    <?php blog_tag($value['logid']); ?> 输出日志的标签,该函数位于模板module.php内。


    <?php echo $value['comnum']; ?> 输出当前日志的评论数


    <?php echo $value['tbcount']; ?> 输出当前日志的引用量


    <?php echo $value['views']; ?> 输出当前日志的浏览量


    <?php echo $page_url;?> 显示当前列表页的翻页功能。


    <?php include View::getView('side'); include View::getView('footer'); ?>


    加入侧边栏及加入页脚。


    echo_log.php


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


    <?php topflg($top); ?> 显示置顶标记,该函数位于模板module.php内。


    <?php echo $log_title; ?> 输出日志标题。


    <?php blog_author($author); ?> 输出日志的作者,该函数位于模板module.php内。


    <?php echo gmdate('Y-n-j G:i l', $date); ?> 输出日志发布时间,参数'Y-n-j G:i l'用于定义日期格式。


    <?php blog_sort($logid); ?> 输出日志所属的分类,该函数位于模板module.php内。


    <?php editflg($logid,$author); ?> 当管理员或作者登陆时显示“编辑”链接,该函数位于模板module.php内。


    <?php echo $log_content; ?> 输出日志全文内容。


    <?php blog_att($logid); ?> 如日志有附件则输出附件,该函数位于模板module.php内。


    <?php blog_tag($logid); ?> 输出日志的标签,该函数位于模板module.php内。


    <?php echo $comnum; ?> 日志页显示评论数


    <?php echo $tbcount; ?> 日志页显示引用数


    <?php echo $views; ?> 日志页显示浏览量


    <?php doAction('log_related', $logData); ?> 相关日志的挂载点,与3.x版本不同,4.0带第二参数。


    <?php neighbor_log($neighborLog); ?> 输出邻近,就是上一篇及下一篇,该函数位于模板module.php内。


    <?php blog_trackback($tb, $tb_url, $allow_tb); ?> 输出该日志被引用的信息列表,与3.x不同注意区分。


    <?php blog_comments($comments); ?> 输出该日志评论列表,与3.x不同注意区分。


    <?php blog_comments_post($logid,$ckname,$ckmail,$ckurl,$verifyCode,$allow_remark); ?> 输出发表评论框,与3.x不同注意区分。


    page.php


    该文件写法与echo_log.php类似,不再重复。


    t.php


    与之前相同的内容不再重复。 <?php echo $avatar; ?> 输出头像。


    <?php echo $author; ?> 输出作者名。


    <?php echo $val['t'];?> 输出碎语内容。


    <?php echo DYNAMIC_BLOGURL; ?> 根据当前url输出博客地址,主要用于js,解决跨域问题。


    <?php echo $tid;?> 输出碎语所在数据库中的id号。


    <?php echo $val['date'];?> 发布碎语的时间。


    $reply_code :其值为‘n’或‘y’,后台设置是否启用碎语回复验证码。


    <?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页面的模板。


    最后附:前台模板部分挂载点一览


    doAction('index_footer'); 页脚底部挂载点


    doAction('index_loglist_top'); 首页日志列表顶部挂载点


    doAction('log_related', $logData); 相关日志挂载点


    doAction('diff_side'); 侧边栏挂载点

    正文到此结束
    您阅读这篇文章共花了: 
    本文链接:http://www.suozy.cn/post-20.html
    版权声明:若无特殊注明,本文皆为《小小的一世》原创,转载请保留文章出处。

    热门推荐

    Hello! How do you see it?

    你还可以输入250 / 250 个字

    嘻嘻 大笑 可怜 吃惊 害羞 调皮 鄙视 示爱 大哭 开心 偷笑 嘘 奸笑 委屈 抱抱 愤怒 思考 日了狗

    已有2条吐槽

    匿名

    2019-12-13 03:12 辽宁省铁岭市联通
    这个网页是用什么系统搭建的

    小小的一世

    2019-12-13 17:49 山西省太原市联通
    @匿名:emlog

    返回顶部    返回首页    手气不错    手机版本   后花园   
    版权所有:小小的一世    站点维护: 小小的一世   若要幸福,不写忧伤;红尘满界,不道惆怅。 【风雨一生兼程,灵魂轻盈随行】   鲁ICP备15009546号-1