Typecho模板的header页面片

Typecho模板中,一般都会有header.php页面片,用于将页面公共头部抽离出来,减少代码冗余。

Typecho模板的header页面片

header页面片中,可以包含html的head标签和网站导航栏nav。

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

网站标题

$this->options->title()

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

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

此api输出的内容对应后台配置

Typecho模板的header页面片

$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>

如需要了解更多xxxUrl方式,请移步到《Typecho中的Option》,这里将做详细介绍。

搜索引擎优化

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

通过$this->header方式输出

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

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

一般会输出:

<meta name="description" content="Just So So ..." />
<meta name="keywords" content="typecho,php,blog" />
<meta name="generator" content="Typecho 1.0/14.10.10" />
<meta name="template" content="BootMantic" />
<link rel="pingback" href="http://ltest.typechodev.com/index.php/action/xmlrpc" />
<link rel="EditURI" type="application/rsd+xml" title="RSD" href="http://ltest.typechodev.com/index.php/action/xmlrpc?rsd" />
<link rel="wlwmanifest" type="application/wlwmanifest+xml" href="http://ltest.typechodev.com/index.php/action/xmlrpc?wlw" />
<link rel="alternate" type="application/rss+xml" title="RSS 2.0" href="http://ltest.typechodev.com/index.php/feed/" />
<link rel="alternate" type="application/rdf+xml" title="RSS 1.0" href="http://ltest.typechodev.com/index.php/feed/rss/" />
<link rel="alternate" type="application/atom+xml" title="ATOM 1.0" href="http://ltest.typechodev.com/index.php/feed/atom/" />

自定义输出

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

keywords

<meta name="keywords" content="<?php $this->keywords() ?>" />

将会输出后台配置的关键字信息。

keywords()函数接受两个参数:

public function keywords($split = ',', $default = '')
{
    echo empty($this->_keywords) ? $default : str_replace(',', $split, htmlspecialchars($this->_keywords));
}

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

description

<meta name="description" content="xxx" />

举例:

<?php if(!$this->is('index')):?>
    <meta name="description" content="TypechoDev是一个专注于Typecho模板制作插件开发、TE安全等技术的站点..." />
<?php elseif(!$this->is('post')):?>
    <meta name="description" content="<?php $this->options->description() ?>" />
<?php esle: ?>
    <meta name="description" content="<?php $this->excerpt(200) ?>" />
<?php endif?>

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

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


版权声明:未经书面授权禁止转载、摘编、复制或建立镜像。对既成事实本站将保留所有的权利。