Typecho模板的header页面片

2016-11-04 8点热度 0人点赞 0条评论

Typecho模板中,一般都会有header.php页面片,用于将页面公共头部抽离出来,减少代码冗余。
header页面片中,可以包含html的head标签和网站导航栏nav。

<!DOCTYPE html>
<html>
<head>
    <title>这是一段标题</title>
    <!-- 各种meta-->
    <meta charset="UTF-8"/>
    <!-- 各种css资源-->
    <link rel="stylesheet" href="http://xxx.com/xxx.css"/>
</head>
    <nav>
        <ul><li></li></ul>
    </nav>

网站标题

$this->options->title()

<title></title>标签中包含网站的标题,可以使用$this->options->title()直接输出。

<title><?php $this->options->title(); ?></title>

此api输出的内容对应后台配置:站点名称

$this->archiveTitle()

此api可用于快速输出文章页的标题。一般用法为:

<title><?php $this->archiveTitle(array(
        'category'  =>  _t('分类 %s 下的文章'),
        'search'    =>  _t('包含关键字 %s 的文章'),
        'tag'       =>  _t('标签 %s 下的文章'),
        'author'    =>  _t('%s 发布的文章')
    ), '', ' - '); ?>
</title>

以上代码表示,如果当前页面是category,则输出“分类 %s 下的文章”,如果当前页面是search,那么输出“包含关键字 %s 的文章”,其他类推。
archiveTitle()函数的第二个参数是$before,第三个是$after,即分别会拼接在第一个参数的前面和后面。譬如在文章页“这是一篇测试文章”的文章下,

$this->archiveTitle(array(
    'post'  =>  _t('这是一篇名为 %s 的文章'),
    ),'前面的文字','后面的文字');

会输出:

前面的文字这是一篇名为 这是一篇测试文章 的文章后面的文字

以上两种输出标题的方式,各位筒子根据自己的需要使用,或者配合is函数使用。

资源加载

加载html静态资源,主要是能够在模板中找到资源所在的位置。

$this->options->themeUrl()

themeUrl()用于加载当前模板下的资源文件。假如当前模板未usr/themes/demo,模板目录下存在资源文件css/style.css,那么

<link rel="stylesheet" href="<?php $this->options->themeUrl('css/style.css'); ?>">

将输出:

<link rel="stylesheet" href="htt://your-site.com/usr/themes/demo/css/style.css">

同理,通过这种方式可以定位js等其他有需要的资源文件。

$this->options->adminUrl()

有时,你可能需要用到admin目录下的资源文件,譬如typecho后台的js/html5shiv.js就是一个很优秀的库。如果你的模板需要引用此文件,怎么加载呢?很简单,使用相类似的adminUrl()即可。

<script src="<?php $this->options->adminUrl('js/html5shiv.js'); ?>"></script>

搜索引擎优化

header中的SEO,主要是优化title输出(见上文),另外还可以在head标签中增加description和keywords字段。
譬如:

<meta name="description" content="Just So So ..." />
<meta name="keywords" content="typecho,php,blog" />

通过$this->header方式输出

Typecho自带的$this->header()函数,可以胜任绝大部分情况,同时,如无特殊需求,也建议使用这种方式输出,是因$this->header()函数考虑了很多情况,适合大部分的场景。
header()的定义可参考/var/Widget/Archive.php

<?php $this->header()?>

一般会输出:

<title><?php $this->options->title(); ?></title>

自定义输出

当然,如果你的需求比较特殊,系统自带的header()函数无法满足你的需求,那么可以使用api自己拼接html代码。
keywords

<title><?php $this->options->title(); ?></title>

1
将会输出后台配置的关键字信息。
keywords()函数接受两个参数:

<title><?php $this->options->title(); ?></title>

2
第一个参数是分隔符,第二个参数是默认值,即如果后台没有配置关键字,那么会输出默认信息。
description

<title><?php $this->options->title(); ?></title>

3
举例:

<title><?php $this->options->title(); ?></title>

4
以上例子,即可根据不同页面输出不同的description内容。

注意:如果没有使用$this->header()的方式,那么插件挂载点headerOptions将失效。

余味

折腾最是有趣

文章评论