WordPress函数:页面标题title标签的获取,wp_get_document_title()、wp_title()和title-tag

编辑于:2019年11月01日
WordPress函数:页面标题title标签的获取,wp_get_document_title()、wp_title()和title-tag

WordPress 的 title 标签是用来定义页面标题的,wp_get_document_title()wp_title()title-tag都可以获取 WordPress 的 title 标签。但要注意,随着 WordPress 版本的迭代 wp_title() 已被弃用,目前主要使用的函数是 wp_get_document_title()。

wp_get_document_title()

基础用法

<title><?php echo wp_get_document_title(); ?></title>

WordPress 4.4.0版本开始,加入了新函数 wp_get_document_title(),使用时只需要将上方代码添加到在主题header.php/head标签前。

高级用法

<?php
    function custom_document_title_separator()
    {
        $separator = ' | '; //自定义的分隔符号
        return $separator;
    }
    add_filter('document_title_separator', 'custom_document_title_separator');

    function reform_page_title($title)
    {
        $title['tagline'] = 'Site description when on home page.'; //网站描述
        $title['page'] = 'Page number if paginated.';  //分页页码
        $title['site'] = 'Site title when not on home page.';  //不在首页时的网站标题
        return $title;
    }
    add_filter('document_title_parts', 'reform_page_title', 10, 1);
?>

在主题functions.php中添加如上代码,用来自定义分隔符号和对已生成的title标题进行二次修改。

注意事项

function disableYoastTitleRewrite() {
    if (class_exists('WPSEO_Frontend') {
        $wpseo_front = WPSEO_Frontend::get_instance();

        remove_filter( 'pre_get_document_title', array( $wpseo_front, 'title' ), 15 );
        remove_filter( 'wp_title', array( $wpseo_front, 'title' ), 15 );
    }
}
add_action( 'init', 'disableYoastTitleRewrite');

如果你使用了Yoast SEO插件,需要在激活插件后在主题的functions.php中添加上述代码(WPSEO (~3+) and WordPress (4.4+))阻止title被重写。

title-tag

WordPress 4.1.0 版本开始添了'title-tag'在主题中显示标题,用以取代之前的 wp_title() 函数,具体用法如下:

function add_theme_support_title(){
         add_theme_support( 'title-tag' );
}
add_action( 'after_setup_theme', 'add_theme_support_title' );

先在主题functions.php添加上述函数。

 <?php wp_head(); ?>

然后在主题头部文件header.php/head标签内添加上面的代码(如果已经有了就不用添加了)。

wp_title()

WordPress 4.4 将弃用 wp_title() 函数了,不再推荐你继续,这部分内容算是对 wp_title() 函数的一些记录吧。

在 wp_title() 中通常是在页面头部的 title 元素中。当 wp_title() 在主页主循环(loop)外时,可以用在模板的任何地方。

<?php wp_title( $sep, $echo, $seplocation ); ?> 

参数: $sep (字符串)(可选)显示在文章标题前后的文字信息(如分隔符)。

默认情况下(若分隔符被设为空)那么文章标题前后(由seplocation参数决定)会显示» (»)符号。 默认值: » (») $echo (布尔型)(可选)回应标题(True),或以PHP字符串形式返回标题(False)。

默认值:True 1 (True) ——默认值 0 (False) $seplocation (字符串)(可选)引入于WordPress 2.5,该参数决定sep字符串相对于文章标题的位置。除“right”外的所有值都会将sep放在文章标题前(左侧)。

如果 seplocation 的值为'right',那么sep字符串会显示在文章标题后。 默认值:None

范例一:

<title><?php wp_title( '|', true, 'right' ); ?></title>

在 WordPress 主题头部文件header.php/head标签内添加上面的代码。

范例二:

<title> 
   <?php 
         if (is_home()||is_search()) { bloginfo('name'); }//首页和搜索页显示网站名字,如 玩个机吧
         else{wp_title(''); echo ' | '; bloginfo('name');} //其它页面显示页面标题和网站名字,如 谋篇文章 WordPress函数 | 玩个机吧
    ?> 
 </title>

在 WordPress 主题头部文件header.php/head标签内添加上面的代码。

相关推荐