the_title()
Выводит на экран заголовок записи. Принято использовать внутри цикла.
Особенностью является, то что заголовок для "личных" и "защищенных" постов будет помечен соответственно: "Защищен: " (Protected: ) и "Личное: " (Private: )
Работает на основе: get_the_title()
1 раз — 0.004764 сек (очень медленно) | 50000 раз — 1.99 сек (быстро) | PHP 7.1.2, WP 4.7.3
Хуков нет.
Возвращает
null|Строку. null когда результат выводится на экран ($echo=true). Строку, когда ($echo=false).
Использование
<?php the_title( $before, $after, $echo ); ?>
- $before(строка)
- Текст/HTML код который нужно разместить перед заголовком.
По умолчанию: пусто - $after(строка)
- Текст/HTML код который нужно разместить после заголовка.
По умолчанию: пусто - $echo(логический)
- Вывести на экран (true) или возвратить для дальнейшей обработки (false).
По умолчанию: true
Примеры
#1 Получим заголовок записи в переменную
Чтобы получить значение для обработки в PHP, укажите третий параметр $echo, как false или 0. Или используйте функцию get_the_title()
$title = the_title('', '', 0);
// или
$title = get_the_title(); #2 Выведем на экран заголовок записи в html теге H3:
<?php the_title( '<h3>', '</h3>' ); ?>
или можно так:
<h3><?php the_title(); ?></h3>
#3 Вывод заголовка с текстом до него:
<?php the_title( 'Текст до заголовка: ' ); ?>
Список изменений
| С версии 0.71 | Введена. |
Код the_title() the title WP 6.6.2
function the_title( $before = '', $after = '', $display = true ) {
$title = get_the_title();
if ( strlen( $title ) === 0 ) {
return;
}
$title = $before . $title . $after;
if ( $display ) {
echo $title;
} else {
return $title;
}
}