the_title() WP 0.71
Выводит на экран заголовок записи. Принято использовать внутри цикла.
Особенностью является, то что заголовок для "личных" и "защищенных" постов будет помечен соответственно: "Защищен: " (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. Выведем на экран заголовок записи в 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();
Список изменений
С версии 0.71 | Введена. |
Код the_title() the title WP 5.6
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 (заголовок)
Еще из раздела: Записи: посты, страницы, ...
- edit_post_link()
- get_delete_post_link()
- get_edit_post_link()
- get_permalink()
- get_post_field()
- get_post_status()
- get_post_time()
- get_sample_permalink()
- get_the_content()
- get_the_date()
Еще из тегов шаблона: Записи: посты, страницы, ...
- body_class()
- get_post_format()
- have_posts()
- in_the_loop()
- next_image_link()
- next_post_link()
- next_posts_link()
- post_class()