很抱歉,最近很忙,没有时间上来更新内容哈。
上篇文章《typecho主题制作文件结构》介绍了制作typecho主题所需要的模板文件,其中有一个特殊的文件,叫“皮肤函数”,文件名为functions.php,。本文将详细介绍此文件的作用。
文件在何时被加载 《typecho中widget_archive解析》中有介绍,typecho大部分请求的路由,都会转发到widget_archive中,在execute()函数中,即大概1357行处,有如下代码:
/** 初始化皮肤函数 */ $functionsfile = $this->_themedir . 'functions.php'; if (!$this->_invokefromoutside && file_exists($functionsfile)) { require_once $functionsfile; if (function_exists('themeinit')) { themeinit($this); } }
可见,在widget_archive加载目标模板文件前,会先加载模板目录下的functions.php文件,并尝试执行其中的themeinit函数,$this作为参数。
文件中可定义的特殊函数 上文提及了themeinit函数,会在所有模板文件被执行前执行,及可以认为是模板代码中第一个被执行的函数。类似的特殊函数还有:
* themeinit
* themeconfig
* themeconfighandle
* themefields
* threadedcomments
* singleping
* treeviewcategories
themeinit函数
themeinit函数会在所有模板文件前加载,一般用于配置typecho行为,譬如修改默认pagesize为20等。
function themeinit($archive) { if ($archive->is('index')) { $archive->parameter->pagesize = 20; // 自定义条数 }}
其作用就是,主页中每页显示文章数由默认值改成20.
themeconfig函数
此函数用于生成模板在后台的配置选项。譬如如下函数,将生成如图的配置页面。
function themeconfig($form) { $logourl = new typecho_widget_helper_form_element_text('logourl', null, null, _t('站点logo地址'), _t('在这里填入一个图片url地址, 以在网站标题前加上一个logo')); $form->addinput($logourl); $sidebarblock = new typecho_widget_helper_form_element_checkbox('sidebarblock', array('showrecentposts' => _t('显示最新文章'), 'showrecentcomments' => _t('显示最近回复'), 'showcategory' => _t('显示分类'), 'showarchive' => _t('显示归档'), 'showother' => _t('显示其它杂项')), array('showrecentposts', 'showrecentcomments', 'showcategory', 'showarchive', 'showother'), _t('侧边栏显示')); $form->addinput($sidebarblock->multimode());}
以上代码的效果:
themeconfighandle函数
还没有搞明白怎么用,欢迎大侠补充哈
themefields函数
作用类似themeconfig吧,这个也没有仔细研究过。
threadedcomments函数
此函数用于配置评论输出。譬如:
function threadedcomments($comments, $options) { echo '自定义内容1'; $comments->content(); echo '自定义内容2';}
那么listcomments(); ?>将输出:
自定义内容1 评论内容 自定义内容2自定义内容1 评论内容 自定义内容2...
singleping函数
//这个也没有研究出是干什么的哈
treeviewcategories函数
此函数用于修改分类的输出样式。具体怎么使用,我研究下再补充上来哈。
文件还可以定义自定义函数 另外,由于functions.php在模板最前面加载,因此这里可以定义自己的函数,并在模板中使用。
举例,最常用的菜单高亮功能中,我们可以在functions.php中定义一个函数判断是否应该高亮当前菜单:
function active_current_menu($archive,$expected,$active_class='active'){ if($expected == 'index' && $archive.is('index')){ echo $active_class; }else if($archive.is('archive') && $archive.getarchiveslug() == $expected){ echo $active_class; }else{ echo ''; }}
那么在模板文件中,可以这样使用:
首页 模板 插件 ... ...
但要注意,functions.php是在widget_archive的execute函数中require进来的,因此functions.php中定义的函数都不能直接使用$this,即不能直接访问widget_archive内部变量。如果需要使用widget_archive的内容,可以通过函数参数的形式传进去,譬如上面的例子。
文章转载自:www.typechodev.com