新的 WordPress 网页标题设置方法

就在刚刚,WordPress 推送了 4.4 正式版,可以在后台进行升级。对于主题开发者来说,需要注意的是:官方已经不再推荐使用 wp_title() 函数来添加网页标题,而是将网页标题变成了一个主题功能。

以前

以前,带有网页标题的 header.php 文件应该是类似这样的,在一对 <title> 标签中调用 wp_title() 函数。

wp_title() 函数会根据条件标签函数判断当前的页面,生成并输出对应的网页标题。

但是,这种方法在 WordPress 4.4 之后已经不推荐继续使用。

新的标题设置方法

随着 wp_title() 的废弃,与之而来的是新方法。你可以在主题的 functions.php 文件中,添加下边的代码来添加网页标题。

代码中,使用 add_theme_support() 函数添加了 “title-tag” 功能,也就是新增的网页标题标签功能。

加入这些代码之后,相当于告诉 WordPress 在 wp_head() 函数处输出一对 <title> 标签,并且包括当前页面的标题。

在这之后,只需保持你的 header.php 中带有 wp_head() 函数即可,不需要再添加 <title> 标签以及 wp_title() 函数。

向下兼容

虽然 WordPress 到 4.4 版本才正式放弃 wp_title() 函数,但是新的标题添加方法早在 4.1 就已经添加到了核心代码中。也就是说,新的方法在 4.1 及其以上版本可以运行,但如果要兼容更老的版本,需要同时在 functions.php 中添加下边的代码。

标题过滤器

随着新的方法,同时添加了一些新的过滤器钩子,可以让你控制网页标题的内容。

  • pre_get_document_title:可以让你完全控制标题内容,如果该过滤器不返回空,则会将返回值直接当做标题。
  • document_title_separator:新的标题分隔符是 “-”,你可以用这个过滤器来修改,比如改成之前的 “|”。
  • document_title_parts:自定义标题的各个组成部分,它们分别是:标题、页码、网站描述和网站名称。

pre_get_document_title

改过滤器可以完全自定义标题的内容,比如把所有页面的标题都改成 “EndSkin”。

这样,每个网页的标题都会变成 “EndSkin”。

或者,通过自定义字段的方式来让每篇文章自定义不同的标题。

添加这段代码之后,在任何文章中都可以通过 “custom_document_title” 自定义字段来设置网页标题,如果文章没添加自定义字段就会返回空,使用默认标题。

document_title_separator

用于修改标题每个项目之间的分隔符,比如修改成 “|”。

之前,大多数人使用的标题分隔符都是 “|”,但现在默认变成了 “-”,会导致网站继续所有页面的标题发生变化,所以可以先改回来。

document_title_parts

这个过滤器会传给我们标题的各个部分,是一个数组,可以修改数组来自定义最终生成的标题。

例如,首页标题默认是 “网站名称 - 网站描述” 的形式,如果你不想要网站描述,可以删除数组中的 tagline

发表评论

11 条评论

  1. 子歇 说道:

    官方文档链接发个吧。

    1. 斌果 说道:

      我扒源码看的,文档找了下,大概就是这个了:https://developer.wordpress.org/reference/functions/wp_get_document_title/

  2. king 说道:

    那是否以前的版本 会出现错误
    移除之后

    1. 斌果 说道:

      4.1 版本之前会出现没有标题的问题,但是一般也不用考虑了,向下兼容考虑两三个版本就行了

      1. king 说道:

        心中一直有个疑问,做wp开发,要一直更随版本进行,还不如学框架,自主开发

        1. 斌果 说道:

          很难做到 WordPress 的体验以及插件扩展

  3. 小河 说道:

    display 后少了个字符 ’

    1. 斌果 说道:

      谢谢提醒

  4. 小河 说道:

    :mrgreen: 非常感谢 正好需要

  5. 小河 说道:

    请教下,自定义字段定义标题,怎么加入网站名称到后面啊?

    1. 斌果 说道:

      在后边连接站名: