Выводит или возвращает (в зависимости от параметров) заголовок текущей записи. Эта функция может использоваться только внутри цикла. Чтобы получить заголовок вне цикла – используйте get_the_title().
Если запись Защищена паролем, к заголовку будет добавлен текст “Защищен:”, если запись Личная, будет добавлен текст “Личное:”.
Использование
<?php the_title( $before, $after, $echo ); ?>
- $before строка
- Текст, расположенный до заголовка
По умолчанию: пусто - $after строка
- Текст, расположенный после заголовка
По умолчанию: пусто - $echo логический
- Выводит заголовок, если задано true и возвращает для использования, если задано false
По умолчанию: true
Возвращает
строку|ничего
Заголовок текущей записи в цикле, если параметр $echo установлен false.
Примеры
1. Выводит на экран заголовок записи в теге H1
the_title( '<h1>', '</h1>' );
2. Получить заголовок в переменную
Вы можете передать третьим параметром false, чтобы не выводить на экран и вернуть значение, для дальнейшей работы. Но, обычно для этого используют get_the_title().
$title = the_title( '', '', false );
Теперь Вы можете использовать переменную $title для изменения заголовка.
3. Заголовок с ссылкой на запись
Если в цикле Вам нужно вывести заголовок с ссылкой на сам пост, воспользуйтесь кодом:
<a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
Исходный код the_title()
Расположен в wp-includes/post-template.php строка 42
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;
}