the_title() WP 0.71

Выводит на экран заголовок записи. Принято использовать внутри цикла.

Особенностью является, то что заголовок для "личных" и "защищенных" постов будет помечен соответственно: "Защищен: " (Protected: ) и "Личное: " (Private: )

Хуков нет.

Возвращает

null/строку. null когда результат выводится на экран ($echo=true). Строку, когда ($echo=false).

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

<?php the_title( $before, $after, $echo ); ?>

$before(строка)

Текст/HTML код который нужно разместить перед заголовком.
По умолчанию: пусто

$after(строка)

Текст/HTML код который нужно разместить после заголовка.
По умолчанию: пусто

$echo(логический)

Вывести на экран (true) или возвратить для дальнейшей обработки (false).
По умолчанию: true

Примеры

#1. Выведем на экран заголовок записи в html теге H3:

<?php the_title( '<h3>', '</h3>' ); ?>

или можно так:

<h3><?php the_title(); ?></h3>

#2. Вывод заголовка с текстом до него:

<?php the_title( 'Текст до заголовка: ' ); ?>

#3. Получим заголовок записи в переменную

Чтобы получить значение для обработки в PHP, укажите третий параметр $echo, как false или 0. Или используйте функцию get_the_title()

$title = the_title('', '', 0);

// или 
$title = get_the_title();

Список изменений

Код the title: wp-includes/post-template.php ^{WP 5.4.2}

<?php
function the_title( $before = '', $after = '', $echo = true ) {
	$title = get_the_title();

	if ( strlen( $title ) == 0 ) {
		return;
	}

	$title = $before . $title . $after;

	if ( $echo ) {
		echo $title;
	} else {
		return $title;
	}
}

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

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

Еще из раздела: Записи: посты, страницы, ...

Еще из тегов шаблона: Записи: посты, страницы, ...