the_title()

Функция the_title() используется для вывода на экран или получения заголовка текущей записи/страницы. Параметры функции позволяют добавить заголовку дополнительную разметку. Функция применяется внутри цикла WordPress.

Параметры

• $before string
  строка, которая будет добавлена перед заголовком (например, тег <h1>)
  По умолчанию: ''
• $after string
  строка, которая будет добавлена после заголовка (например, закрывающий тег </h1>)
  По умолчанию: ''
• $display bool
  если true, заголовок будет выведен на экран, если false, то вернет его для использования в коде (можно записать в переменную)
  По умолчанию: true
  

the_title( $before, $after, $display );

Возвращает

void|string void, если параметр $display равен true, строку (заголовок записи), если $display равен false

Дополнительная информация

1. Для правильной работы функции the_title() используйте ее внутри цикла WordPress. При использовании вне цикла будет выведет заголовок первого поста цикла. Во избежании ошибок, вне цикла лучше использовать функцию get_the_title().
2. Если запись помечена как Личное или Защищено паролем, то перед заголовком будет выведен префикс "Защищен:" и "Личное:"

Примеры использования

Пример 1. Стандартный вывод заголовка

if ( have_posts() ) {
	while ( have_posts() ) {
		the_post();
		the_title();
	}
}

Пример 2. Вывод заголовка в теге <h1>

if ( have_posts() ) {
	while ( have_posts() ) {
		the_post();
		the_title('<h1>', '</h1>');
	}
}

Пример 3. Запись заголовка в переменную и вывод на экран

if ( have_posts() ) {
	while ( have_posts() ) {
		the_post();
		$title = the_title('', '', false);
		echo $title;
	}
}

Пример 4. Вывод с дополнительным текстом перед заголовком

if ( have_posts() ) {
	while ( have_posts() ) {
		the_post();
		the_title('Статья –', '');
	}
}

Перед заголовком будет добавлен дополнительный текст Статья –. Например, если статья называется "Какое расстояние от Земли до Солнца?", то код выведет на экран "Статья – Какое расстояние от Земли до Солнца?".

Хуки

the_title protected_title_format private_title_format

Информация о функции