emlog模板制作帮助手册

emlog基本模板文件

必须文件：

main.css： CSS(样式表)文件 

log_list.php： 日志列表页模板 

echo_log.php： 日志页模板 

page.php： 页面（page）模板 

footer.php： Footer模板 

header.php： Header模板 

t.php： 碎语模板 

module.php： 包含widgets、评论、引用、编辑等 

可选文件：

side.php ： 侧边栏模板 

基本条件判断Tag 

$curpage：当前页面表示，常用判断tag如下： 

$curpage== CURPAGE_HOME：首页 

$curpage == CURPAGE_TW：碎语页 

$curpage == CURPAGE_LOG：日志、page页 

ROLE：当前访问者身份 

ROLE == 'admin'：管理员 

ROLE == 'writer'：联合撰写人 

ROLE == 'vistor'：未登录用户 

模板PHP标签说明 

通用： 

<?php if(!defined('EMLOG_ROOT')) {exit('error!');} ?>存在每个php文件头部，防止非法访问 

<?php include getViews('XXXX');; ?>： 调用当前模板目录下XXXX.php文件 

<?php echo EMLOG_VERSION;?>：显示当前emlog版本 

<?php echo TEMPLATE_URL; ?>： 显示模板文件路径 

<?php echo BLOG_URL; ?>： 显示博客Url 

<?php echo $blogtitle; ?>： 显示博客标题（会根据当前页面变化） 

<?php echo $blogname; ?>： 显示博客名称 

<?php echo $bloginfo; ?>：显示博客描述 

<?php echo $icp; ?>：显示备案号 

<?php endforeach; ?>： 循环结束，需和<?php foreach(xxxx): ?>配对 

<?php endif;?>：结束if标签，需和<?php if(xxxx): ?>配对 

header.php 

<?php /* 

Template Name:模板名称 Description:模板描述 Author:模板作者 Author Url:作者主页 

Sidebar Amount:侧边栏数目，最大4 */ ?> 

模板注释，存在于header.php头部，可为空 

<?php doAction('navbar', '左标签', '右标签'); ?>：插件挂载点，用于导航栏，左右标签为html标签，用以控制样式，可为空 

<?php if($istwitter == 'y'):?>：如果后台设置前台可见碎语链接 

<?php 

foreach ($navibar as $key => $val): if ($val['hide'] == 'y'){continue;} 

if (empty($val['url'])){$val['url'] = BLOG_URL.'?post='.$key;} 

?>：开始导航循环 

footer.php 

<?php doAction('index_footer'); ?>：插件挂载点（用于统计代码等） 

echo_log.php 

<?php topflg($top); ?>：置顶标志，函数存在于module.php 

<?php echo $log_title; ?>：显示日志、page标题 

<?php echo $log_content; ?>：显示日志内容 

<?php blog_sort($sortid, $logid); ?>：显示分类，该函数存在于module.php 

<?php editflg($logid,$author); ?>：显示编辑链接，函数存在于module.php 

<?php blog_author($author); ?>：显示日志作者，函数存在于module.php 

<?php echo gmdate('Y-n-j G:i l', $date); ?>：日志发表时间，格式是2010-12-11 19:05 30，格式可修改 

<?php blog_att($logid); ?>：显示日志附件（图片附件不显示），函数存在于module.php 

<?php blog_tag($logid); ?>：显示日志标签，函数存在于module.php 

<?php doAction('log_related'); ?>：插件挂载点（用于相关日志等） 

<?php neighbor_log(); ?>：显示相邻日志，函数存在于module.php 

<?php blog_trackback(); ?>：显示引用通告地址及引用，函数存在于module.php 

<?php blog_comments(); ?>：显示日志评论，函数存在于module.php 

<?php if ($allow_remark == 'y'){blog_comments_post();}?>：根据是否允许评论显示评论表单，函数存在于module.php 

page.php 

<?php echo $log_title; ?>：显示日志、page标题 <?php echo $log_content; ?>：显示日志内容 

<?php blog_att($logid); ?>：显示附件（图片附件不显示），函数存在于module.php 

<?php if ($allow_remark == 'y'){blog_comments();blog_comments_post();} ?> ：根据是否允许评论显示评论和评论表单，函数存在于module.php 

log_list.php 

<?php doAction('index_loglist_top'); ?>：插件挂载点，存在于列表顶部（用于公告等） 

<?php foreach($logs as $value): ?>： 开始循环输出日志列表 

---------------------------------

以下仅存在于<?php foreach($logs as $value): ?>和<?php endforeach; ?>之间 

<?php topflg($value['top']); ?>：置顶标志，函数存在于module.php 

<?php echo $value['log_title']; ?>：显示日志标题 

<?php echo $value['log_description']; ?>：显示日志摘要 

<?php blog_sort($value['sortid'], $value['logid']); ?>：显示分类，该函数存在于module.php 

<?php editflg($value['logid'],$value['author']); ?>：显示编辑链接，函数存在于module.php 

<?php blog_author($value['author']); ?>：显示日志作者，函数存在于module.php 

<?php echo gmdate('Y-n-j G:i l', $value['date']); ?>：日志发表时间，格式是2010-12-11 19:05 30，格式可自行修改 

<?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 foreach($logs as $value): ?>和<?php endforeach; ?>之间 

<?php echo $page_url;?>：显示分页 

side.php 

<?php 

$widgets = !empty($options_cache['widgetsX']) ? unserialize($options_cache['widgetsX']) : array(); 

?> 

：该页面要加载的widgets，X为数字，不超过header.php里设置的侧边栏数目 

<?php doAction('diff_side'); ?>：插件挂载点 

<?php 

foreach ($widgets as $val) { 

$widget_title = @unserialize($options_cache['widget_title']); 

$custom_widget = @unserialize($options_cache['custom_widget']); 

if(strpos($val, 'custom_wg_') === 0) { 

$callback = 'widget_custom_text'; if(function_exists($callback)) { 

call_user_func($callback, htmlspecialchars($custom_widget[$val]['title']), $custom_widget[$val]['content'], $val); 

} 

}else{ 

$callback = 'widget_'.$val; if(function_exists($callback)) { 

preg_match("/^.*\s\((.*)\)/", $widget_title[$val], $matchs); 

$wgTitle = isset($matchs[1]) ? $matchs[1] : $widget_title[$val]; call_user_func($callback, htmlspecialchars($wgTitle));

 }

 }

 } 

?>：这一长串用于显示widgets 

module.php（建议参考默认模板里的注释） 

function widget_xxxx($title)：显示widgets函数，如widget_blogger($title)显示博主信息 

t.php 

<?php 

foreach($tws as $val): 

$author = $user_cache[$val['author']]['name']; 

$avatar = empty($user_cache[$val['author']]['avatar']) ? BLOG_URL . 'admin/views/' . ADMIN_TPL . '/images/avatar.jpg' : BLOG_URL . 

$user_cache[$val['author']]['avatar']; $tid = (int)$val['id'];

 ?>：开始循环输出碎语 

<?php echo $author; ?>：显示碎语发布者 

<?php echo $val['t'];?>：显示碎语内容 

<?php echo $pageurl;?>：显示碎语分页 

<?php echo $twnum; ?>：显示碎语数目