Typecho的functions.php

很抱歉,最近很忙,没有时间上来更新内容哈。
上篇文章[《Typecho主题制作文件结构》][1]介绍了制作Typecho主题所需要的模板文件,其中有一个特殊的文件,叫“皮肤函数”,文件名为functions.php,。本文将详细介绍此文件的作用。

## 文件在何时被加载 ##
[《Typecho中Widget_Archive解析》][2]中有介绍,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());
}

以上代码的效果:
![模板配置.png][3]

**themeConfigHandle函数**
还没有搞明白怎么用,欢迎大侠补充哈

**themeFields函数**
作用类似`themeConfig`吧,这个也没有仔细研究过。

**threadedComments函数**
此函数用于配置评论输出。譬如:

function threadedComments($comments, $options) {
echo ‘自定义内容1’;
$comments->content();
echo ‘自定义内容2’;
}
那么`listComments(); ?>`将输出:

  1. 自定义内容1 评论内容 自定义内容2
  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的内容,可以通过函数参数的形式传进去,譬如上面的例子。

[1]: http://www.typechodev.com/index.php/archives/19/
[2]: http://www.typechodev.com/index.php/archives/25/
[3]: https://www.typechodev.com/usr/uploads/2015/02/227246601.png

原创文章,作者:admin,如若转载,请注明出处:https://www.typechodev.com/theme/32.html

(0)
上一篇 2015-01-31 上午1:51
下一篇 2015-01-31 上午2:17

相关推荐

  • Typecho中调用分类下的文章列表

    可能由于Typecho博客模板布局情况,需要单独调用typecho某一分类目录的文章列表,目前为止,没有找到相关的typecho插件,但找到了实现typecho调用某分类目录文章的…

    主题开发 2015-02-28
  • Typecho的错误输出

    在编码联调阶段,出错了只返回一个500页面,对开发人员是不友好的,此时打开错误输出就很有必要。那么,Typecho如何开启错误输出呢? 从/var/Typecho/Common.p…

    主题开发 2014-12-31
  • Typecho按时间归档

    有些时候,我们需要根据时间维度对文章进行归档,或者直接制作时间线(timeline)页,即用于展示博主的点滴。又有时,希望点击文章发布的时间即可直接连接到归档的页面,如发布时间20…

    主题开发 2015-01-31
  • Typecho模板的推荐页面构成

    ## Typecho模板页面构成大多数情况下,Typecho主题模板页面都会包括导航栏、侧边栏、文章正文等元素,如图。![文章构成.png][1] 本教程,将分别针对页面构成的各个…

    主题开发 2015-01-31
  • Typecho模板中的404.php

    普通页面,随意弄即可。 举例: 404 –

    主题开发 2015-01-31
  • Typecho模板的index页面

    ## 制作index.php ### 模板作者信息在index.php的开头,可以使用注释方式添加模板作者信息。 /** * 这是一段描述,写在前面 * @package Type…

    主题开发 2015-01-31
  • typecho自定义字段的那些坑儿

    ## 前言 ##前面的文章《[请输入链接描述][1]》和《[请输入链接描述][2]》基本围绕着怎么扩展typecho的能力展开的,特别针对插入文章的时需要注意的要点和事项。这一节文…

    主题开发 2016-11-30
  • typecho获取每个分类category文章数量代码

    制作模板的时候有些小伙伴们想在分类的右边填写分类的数量,这个时候就需要获取代码片段。代码如下: “`$this->widget(‘Widget_Metas_…

    主题开发 2022-04-20
  • Typecho模板中的Archive.php

    archive,顾名思义,即归档页面,用于展示“文章列表”内容,包括某年月下的文章、搜索结果的文章等等。 基本上,archive.php和index.php都是由Widget_Ar…

    主题开发 2015-01-31
  • typecho主题函数functions.php里面怎么获取$this

    Typecho大部分请求的路由,都会转发到Widget_Archive中,在execute()函数中,即大概1357行处,有如下代码: /** 初始化皮肤函数 */ $functi…

    主题开发 2017-11-30

发表评论

您的电子邮箱地址不会被公开。