WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Теги шаблонов/wp title

Эта страница помечена как незавершённая. Вы можете помочь проекту, дополнив её.

Описание

Выводит или возвращает заголовок страницы. Разделитель можно изменять.А начиная с Version 2.5 можно также указывать расположение разделителя - до или после названия страницы.

Этот Тег шаблона можно использовать повсеместно, как за пределами Цикл_WordPress, так и внутри него. Обычно его используют для указания заголовка страницы в теге <title> в <head> части страницы.

Текст заголовка зависит от страницы, на которой вызывается:

одна запись или страница
заголовок записи или страницы
архив записей за определённое время
дата (например, "2006", "Январь 2006")
рубрика
название рубрики
страница записей автора
отображаемое имя автора

Использование

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

Параметры

$sep
(string) (По умолчанию:) Текст, который будет отображаться до или после заголовка (разделитель).

title.

Default: (»)
$echo
(boolean) (optional) Выводит заголовок (True) или возвращает значение (False) при вызове функции.
Default: True
  • 1 (True) - default
  • 0 (False)
$seplocation
(string) (optional) Introduced with Version 2.5, this parameter defines the location of where the sep string prints in relation to the title of the post. For all values except 'right', the sep value is placed in front of (to the left of) the post title. If the value of seplocation is 'right' then the sep string will be appended after the post title.
Default: None

Примеры

По умолчанию

Displays the blog name (using bloginfo()) and the post title using defaults when accessing a single post page. If the blog name is "My WordPress Blog", and the title of the post is "Hello world!", then the example below will show the title as My WordPress Blog » Hello world!

 <title><?php bloginfo('name'); ?> <?php wp_title(); ?></title>

Turning Off »

If you don't want it to automatically display the » before the page title, just call the function as below:

 <title><?php bloginfo('name'); ?> <?php wp_title("",true); ?></title>

Covering Homepage

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

<title><?php bloginfo('name'); ?> | <?php is_home() ? bloginfo('description') : wp_title(''); ?></title>

Using Separator

Displays blog name (using bloginfo()) along with post title in the document's title tag, using (pipe) "|" as the separator. This results in (when on a single post page) My WordPress Site | Hello world!.

 <title><?php bloginfo('name'); ?><?php wp_title('|'); ?></title>

This example would do the same thing:

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

Additional Separators

Most common are so called pipes ('|') however there are few other that could be used.

Hyphens

 <title><?php bloginfo('name'); ?><?php wp_title('-'); ?></title>

Commas

 <title><?php bloginfo('name'); ?><?php wp_title(','); ?></title>

Spaces

 <title><?php bloginfo('name'); ?><?php wp_title(' '); ?></title>

Not Recommended Separators

When using meta titles site owners need to send a clear message to their users as well as Search Engines. Here are two examples of what websites should avoid.

Double Hyphens

 <title><?php bloginfo('name'); ?><?php wp_title('--'); ?></title>

Underscores

 <title><?php bloginfo('name'); ?><?php wp_title('_'); ?></title>

Underscores will confuse both users and search engines because the title becomes one word instead of several separated words.

Example when using underscores:

My_WordPress_Site instead of My WordPress Site.

Separator with Blog Name and Title Reversed

For Wordpress 2.5 and newer

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

For previous versions

This lets you reverse page title and blog name in the title tag from example above (Hello world!--My WordPress Blog) by removing the separator (using wp_title(' '), then tests if there is a post title (using if(wp_title(' ', false))), and displays the separator between it and bloginfo() if it does.

<title>
 <?php wp_title(' '); ?>
 <?php if(wp_title(' ', false)) { echo '|'; } ?> 
 <?php bloginfo('name'); ?>
 </title>

Схожее

See also index of Function Reference and index of Template Tags.