WordPress как на ладони
wordpress jino

wp_get_document_title() WP 4.4.0

Получает заголовок текущей страницы (документа), который принято выводить в html теге <title>. Замена для устаревшей функции wp_title().

После заголовка документа добавляется название сайта через разделитель ' - '. На главной странице (is_home() && is_front_page()) вместо названия выводится описание сайта.

Если добавить теме поддержку title-tag: add_theme_support('title-tag');, то в head части документа вообще не нужно указывать html тег <title>. Этот тег будет добавлен автоматически в момент работы хука wp_head, который вызывается функцией wp_head(), которая, в свою очередь, всегда добавляется в head темы.

При автоматическом добавлении тега <title> WordPress будет использовать эту функцию для вывода заголовка, т.е. будет добавлена такая конструкция:

<title><?php echo wp_get_document_title(); ?></title>
✈ 1 раз = 0.00042с = быстро | 50000 раз = 15с = медленно
Хуки из функции:
Возвращает

Строку. Заголовок текущей страницы.

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

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

Примеры

#1 Вывод заголовка для всех страниц

Это замена для тега шаблона wp_title(). Используется в header.php для вывода заголовка любой страницы.

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

#2 Вывод заголовка страницы

Допустим мы находимся на странице "Контакты":

echo wp_get_document_title();
// выведет: Контакты - Название сайта

#3 Выведем свой заголовок, используя фильтр

Допустим нам нужно чтобы эта функцию вообще не работала и через нее мы хотим вывести свой заголовок, например "Моя страница", на странице с ID 20:

add_filter( 'pre_get_document_title', function(){
	global $post;

	if( $post->ID != 20 ) return; // выходим если это не нужна нам страница

	return 'Моя страница';
} );

// так на странице 20 будет выведен заголовок "Моя страница"

Аналогично можно написать свою функцию и полностью заменить работу этой функции на свою.

#4 Изменим разделитель между заголовком и названием сайта

По умолчанию функция добавляет в после заголовка название сайта через разделитель: ' - '. Разделитель можно изменить через фильтр:

add_filter( 'document_title_separator', function(){ return ' | '; } );

#5 Удаление названия сайта в конце заголовка

Ко всем заголовкам на отдельных страницах (is_singular()) добавляется название сайта, через разделитель. Это не всегда хорошо, давайте поправим этот момент. Для этого используем фильтр: 'document_title_parts'

add_filter('document_title_parts', function( $parts ){
	if( isset($parts['site']) ) unset($parts['site']);
	return $parts;
});

#6 Удаление описания сайта из заголовка главной страницы

На главной странице выводиться "Название сайта - описание сайта". Чтобы удалить описание и выводить только называние, используйте такой хук:

// удалим описание из заголовка для главной страницы
add_filter('document_title_parts', function($title){
	if( isset($title['tagline']) ) unset( $title['tagline'] );

	return $title;
});

Код wp get document title: wp-includes/general-template.php VER 4.9.1

<?php
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;
	}

	global $page, $paged;

	$title = array(
		'title' => '',
	);

	// If it's a 404 page, use a "Page not found" title.
	if ( is_404() ) {
		$title['title'] = __( 'Page not found' );

	// If it's a search, use a dynamic search results title.
	} elseif ( is_search() ) {
		/* translators: %s: search phrase */
		$title['title'] = sprintf( __( 'Search Results for &#8220;%s&#8221;' ), get_search_query() );

	// If on the front page, use the site title.
	} elseif ( is_front_page() ) {
		$title['title'] = get_bloginfo( 'name', 'display' );

	// If on a post type archive, use the post type archive title.
	} elseif ( is_post_type_archive() ) {
		$title['title'] = post_type_archive_title( '', false );

	// If on a taxonomy archive, use the term title.
	} elseif ( is_tax() ) {
		$title['title'] = single_term_title( '', false );

	/*
	 * If we're on the blog page that is not the homepage or
	 * a single post of any post type, use the post title.
	 */
	} elseif ( is_home() || is_singular() ) {
		$title['title'] = single_post_title( '', false );

	// If on a category or tag archive, use the term title.
	} elseif ( is_category() || is_tag() ) {
		$title['title'] = single_term_title( '', false );

	// If on an author archive, use the author's display name.
	} elseif ( is_author() && $author = get_queried_object() ) {
		$title['title'] = $author->display_name;

	// If it's a date archive, use the date as the title.
	} elseif ( is_year() ) {
		$title['title'] = get_the_date( _x( 'Y', 'yearly archives date format' ) );

	} elseif ( is_month() ) {
		$title['title'] = get_the_date( _x( 'F Y', 'monthly archives date format' ) );

	} elseif ( is_day() ) {
		$title['title'] = get_the_date();
	}

	// Add a page number if necessary.
	if ( ( $paged >= 2 || $page >= 2 ) && ! is_404() ) {
		$title['page'] = sprintf( __( 'Page %s' ), max( $paged, $page ) );
	}

	// Append the description or site title to give context.
	if ( is_front_page() ) {
		$title['tagline'] = get_bloginfo( 'description', 'display' );
	} else {
		$title['site'] = get_bloginfo( 'name', 'display' );
	}

	/**
	 * 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 );

	$title = implode( " $sep ", array_filter( $title ) );
	$title = wptexturize( $title );
	$title = convert_chars( $title );
	$title = esc_html( $title );
	$title = capital_P_dangit( $title );

	return $title;
}

Cвязанные функции

Из метки: title (заголовок)

Еще из раздела: Другие функции темы

wp_get_document_title 10 комментариев
  • seredniy7 cайт: sercraft.com @

    а чем wp_title() не угодил? по-моему полный аналог. Кама, просветитель меня)

    Ответить2 года назад #
    • Kama4696

      Во-первых. Само название wp_title() неопределенное... Подходит для любого заголовка: сайта, записи, документа и т.д. А с wp_get_document_title() сразу ясно о чем речь...

      Во-вторых. Для гибкости и возможности подключаться через плагины, в частности для SEO, просто необходимо использовать хуки (у каждого сайта свои нужды), а wp_title прописывается жестко в html и плагинам приходилось костылями переделывать сам тег в html, а не использовать хуки. Это идет в разрез с общей схемой использования хуков. Кроме того, так сложилось, что обычно заголовок прописывался так:

      <title>wp_title() + bloginfo('name')</title>

      тут даже если через хук изменить заголовок wp_title(), то он полностью не поменяется.

      Далее, разных, уже неправильных, мануалов по wp_title() в сети много. И легче сделать все по-новому, чем объяснить что: были изменения и теперь надо использовать так, а не так. Чтобы от этого отвязаться нужно в корне изменить принцип,тогда уже не будет никакой связи с неправильными мануалами...

      Далее, хук wp_title срабатывает в конце функции, т.е. сначала все операции, а потом хук. И там обычно просто полностью переопределяется работа функции. Это неправильно.

      В итоге получается, что wp_get_document_title() это тоже самое, но с новым подходом... Он вешается через хук wp_head и не используется напрямую в html. Функция сама по себе нигде не вызывается, а изменяться через хуки: можно на начальном этапе все поменять ('pre_get_document_title') или в конце дополнить ('document_title_parts')...

      3
      Ответить2 года назад #
  • Дамир

    Привет, а как его внедрять в шаблон также как и wp_title()
    <title><?php wp_get_document_title(); ?></title>
    или через functions.php?

    Ответить1.9 года назад #
  • Вопрос по пятому примеру. Как можно не просто удалить название сайта, а заменить его на определённый текст (например - Версия для печати)?

    Ответить1.7 года назад #
    • Kama4696
      add_filter('document_title_parts', function( $parts ){
      	if( isset($parts['site']) ) $parts['site'] = 'Версия для печати';
      	return $parts;
      });
      Ответить1.7 года назад #
  • Александр

    а у меня в теме twentysixteen не работает фильтр. Ничего не изменяется. Пробовал убрать запись add_theme_support( 'title-tag' ) и написать вручную вывод заголовка в title, но эффект тот же - показывает Название страницы | Название сайта. А хотелось бы отображать в title только название текущей страницы

    Ответить1.6 года назад #
    • Александр

      Разобрался - просто стоял плагин all in one seo pack

      Ответить1.6 года назад #
  • Игорь cайт: homeowners.ru @

    Здравствуйте!

    А как сделать так, чтобы в заголовке главной страницы оставалось только название сайта без описания? Что-то не совсем понял, как тут хук применить.

    Ответить1.5 года назад #
    • Kama4696

      Там все через фильтр можно менять. Можно даже полностью изменить работу функции. Описание удаляется таким фильтром:

      add_filter('document_title_parts', function($title){
      	// удалим описание из заголовка для главной страницы
      	if( isset($title['tagline']) ) unset( $title['tagline'] );
      
      	return $title;
      });
      Ответить1.5 года назад #

Здравствуйте, !

Ваш комментарий
Предпросмотр