如何在WordPress页面上更改标题?

时间:2016-11-04 05:00:10

标签: php wordpress yoast

上下文:WordPress 5.4.5,Yoast 3.7.1

我是一名有权访问客户网站的插件开发人员。该网站安装了Yoast 3.7.1,我想知道这是否重要,因为无论我做什么,我都无法更改404页面的title

现在在StackOverflow的其他页面上提出了类似的问题(例如hereherehere)。那些回答的人询问header.php是否正确嵌入了对wp_title()的调用。以下是当前主题header.php中的内容:

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

有趣的是,在我的404.php页面中,wp_get_document_title()告诉我文档标题为Page not found - XXXX,即使上面的wp_title调用将分隔符指定为| 。 Yoast对标题的重写已被禁用,所以我不确定那些短跑的来源。

我的插件执行REST调用,并从异地提取内容以包含在页面中。部分内容是title中使用的文本。

在以前的客户网站上,我已经能够执行以下操作:

add_filter('wp_title', 'change_404_title');
function change_404_title($title) {
    if (is_404()) 
    {
        global $plugin_title;
        if (!empty($plugin_title)) 
        {
             $title = $plugin_title;
        }
    }
    return $title;
}

然而,在这个网站上,这不起作用。

我尝试过根据所使用的WordPress版本挂钩pre_get_document_title过滤器,即

add_filter('pre_get_document_title', 'change_404_title');

但又无济于事。我正在读Yoast ...

3 个答案:

答案 0 :(得分:9)

自版本4.4起,

wp_title已弃用。所以我们应该使用新的过滤器pre_get_document_title。你的代码看起来不错,但我对global $plugin_title感到困惑。我宁愿你先试试这个

add_filter('pre_get_document_title', 'change_404_title');
function change_404_title($title) {
    if (is_404()) {
        return 'My Custom Title';
    }
    return $title;
}

如果它不起作用,请尝试更改优先级以便最近执行您的功能。

add_filter('pre_get_document_title', 'change_404_title', 50);

答案 1 :(得分:2)

自Wordpress v4.4.0起,文档标题的生成方式已更改。现在wp_get_document_title指示标题的生成方式:

/**
 * Displays title tag with content.
 *
 * @ignore
 * @since 4.1.0
 * @since 4.4.0 Improved title output replaced `wp_title()`.
 * @access private
 */
function _wp_render_title_tag() {
    if ( ! current_theme_supports( 'title-tag' ) ) {
        return;
    }

    echo '<title>' . wp_get_document_title() . '</title>' . "\n";
}

这是v5.4.2中的代码。这些是您可以用来操作标题标签的过滤器:

function wp_get_document_title() {
    /**
    * Filters the document title before it is generated.
    *
    * Passing a non-empty value will short-circuit wp_get_document_title(),
    * returning that value instead.
    *
    * @since 4.4.0
    *
    * @param string $title The document title. Default empty string.
    */
    $title = apply_filters( 'pre_get_document_title', '' );
    if ( ! empty( $title ) ) {
        return $title;
    }
    // --- snipped ---
    /**
    * Filters the separator for the document title.
    *
    * @since 4.4.0
    *
    * @param string $sep Document title separator. Default '-'.
    */
    $sep = apply_filters( 'document_title_separator', '-' );

    /**
    * Filters the parts of the document title.
    *
    * @since 4.4.0
    *
    * @param array $title {
    *     The document title parts.
    *
    *     @type string $title   Title of the viewed page.
    *     @type string $page    Optional. Page number if paginated.
    *     @type string $tagline Optional. Site description when on home page.
    *     @type string $site    Optional. Site title when not on home page.
    * }
    */
    $title = apply_filters( 'document_title_parts', $title );
    // --- snipped ---
    return $title;
}

因此,您可以通过两种方法来做到这一点。

第一个使用pre_get_document_title过滤器,它可以缩短标题的产生,因此如果您不打算对当前标题进行更改,则可以提高性能:

function custom_document_title( $title ) {
    return 'Here is the new title';
}
add_filter( 'pre_get_document_title', 'custom_document_title', 10 );

第二种方法是,在使用document_title_separator或{{1}之类的函数生成标题之后,使用document_title_partssingle_term_title钩子为标题和标题分隔符添加钩子,稍后在函数中执行},具体取决于页面,并且在标题标签即将输出之前:

post_type_archive_title

答案 2 :(得分:0)

将此添加到您的functions.php

function custom_wp_title($title) {

    if ( is_404() ) {
        $title = 'Custom 404 Title';
    }
    return $title;
}
add_filter( 'wp_title', 'custom_wp_title', 10, 2 );

10 - 是覆盖SEO等其他插件的优先级更改