wp_title()获取当前页面的标题

目录

描述

Display or retrieve page <title> for all areas of blog.

The text for the <title> element is generated based on the type of post, page, archive, etc., being displayed. You may also append or prepend a string to this using the function's parameters. The result may be displayed directly, or returned for further processing.

You can also specify what separator is to be used between the different segments of the title. By default, the separator is displayed before the page title, so that the blog title will be before the page title. This is not good for title display, since the blog title shows up on most tabs and not what is important, which is the page that the user is looking at.

The main reason to have the blog title to the right is for browsers supporting tabs. You can achieve this by using the $seplocation parameter and setting the value to 'right'.

wp_title() 描述

用法

 <?php wp_title$sep$display$seplocation ); ?> 

Best practices

Plugins might use the wp_title filter to generate a value. While it is possible to construct a "title" by doing things such as concatenating with bloginfo (the Site Name), if you do not use the wp_title function in your theme, you will likely have errors or unexpected behavior.

Required for public themes

This function, and not a work-around, is required for publicly by WordPress standards.

wp_title() 用法

参数

The function always returns a value from the database, and the parameters define what information is appended to the database value, where it is appended, and how it is formatted.

$sep

(string) (可选) Short for "separator" is a string appended before or after the value returned from the database. The string may be zero characters, see Examples, below. The sep string typically separates the Site Title (or a similar string) from the "title" of the post or page.

默认值: &raquo; (»)

$display

(boolean) (可选) Formats the return value either for display as text (TRUE) or as a parameter for another PHP function (FALSE).

默认值: TRUE

$seplocation

(string) (可选) Defines whether the sep string is added before (prepended, or to the left) or after (appended, or to the right) of the value returned from the database. If seplocation is right, then the function appends the sep string to the database value: said differently, the sep is placed to the right of the title of the post or page. If seplocation is left or any value other than right, then the function prepends the sep string to the database value. Said differently, the function adds the sep to the left of the title of the post or page. Special case: if $display is FALSE and you do not define the $seplocation parameter, the function will prepend a space to the entire string.

默认值: left

wp_title() 参数

返回值

The function returns a concatenated string. It always queries the database for a default string; the value of the default string depends on the type of post or page:

Single post

the title of the post

Date-based archive 

the date (e.g., "2006", "2006 - January")

Category 

the name of the category

Author page 

the public name of the user

The function then prepends or appends the sep string and returns the entire value.

wp_title() 返回值

示例

Default

If you do not pass any parameters for a single post, for example:

If the title of the post is "Hello world!", then the function will return

Zero-character sep

The sep string may be zero characters, which will remove » from the returned value. To do this, set the sep parameter to zero characters, for example:

If the title of the post is "Hello world!", then the function will return:

Customizing with the filter

If you want to change the way that the title displays on different pages you can use a filter.

Covering Homepage

If you are using a custom homepage with custom loops and stuff or a custom front-page, you will have an empty wp_title. Here goes a neat hack to add the description/tagline at the wp_title place on homepage:

Then in your "functions.php" from theme file :

You can format this string as you want of course.

wp_title() 示例

历史

  • 添加于 版本: 1.0.0
  • 2.5.0: 添加 $seplocation parameter

wp_title() 历史

源文件

wp_title() is in wp-includes/general-template.php.

wp_title() 源文件

相关