the_title()

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

Простыми словами, the_title() выводит название текущего поста или страницы прямо в HTML-шаблон сайта.

Это одна из базовых функций, которая отвечает за отображение заголовков контента в WordPress-темах.

Параметры

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

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

Возвращает

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

Где используется

Функция чаще всего используется в следующих файлах темы:

• single.php — одиночная запись
• page.php — страницы
• index.php — список записей
• archive.php — архивы

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

Пример 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('Статья –', '');
	}
}

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

Частые ошибки

• Использование вне цикла Loop
  Функция работает правильно только при использовании внутри цикла (loop). При использовании вне цикла будет выведет заголовок первого поста в цикле.
• Ожидание возврата значения
  По умолчанию, функция выводит заголовок. Для возврата используйте параметр функции $display = false.
• Путаница с get_the_title()
  Функция get_the_title возвращает название записи и может использоваться вне цикла с указанием параметра $post.

Похожие функции

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

1. Если запись помечена как Личное или Защищено паролем, то перед заголовком будет выведен префикс "Защищен:" и "Личное:"

Хуки

the_title protected_title_format private_title_format

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