Как использовать функцию the_title() в WordPress

# THE_TITLE() ─ WP 0.71

Функция the_title() отображает заголовок текущего поста с возможным HTML-форматированием. Ее можно использовать внутри цикла WordPress.

Если пост защищен паролем или является приватным, на передней части отображается слово "Защищено" или "Приватно" перед заголовком поста.

Если вы хотите добавить заголовок поста в атрибут HTML-тега, используйте функцию the_title_attribute() вместо the_title() или get_the_title(). 

Пример использова��ия:

```html

Время выполнения функции:

• 1 раз — 0.004764 сек (очень медленно)
• 50000 раз — 1.99 сек (быстро)

PHP: 7.1.2, WordPress: 4.7.3

Возвращаемое значение

Функция возвращает null или строку. Возвращает null, когда результат отображается ($echo=true). Возвращает строку, когда ($echo=false).

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

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

• $before (строка): Текст / HTML-код, который будет перед заголовком. По умолчанию: ''
• $after (строка): Текст / HTML-код, который будет после заголовка. По умолчанию: ''

• $echo (true/false): Отображать заголовок или вернуть его для дальнейшей обработки.

  • true — отображение
  • false — возврат для обработки.

По умолчанию: true

Примеры

Пример 1: Отображение заголовка поста в HTML-теге H3

', ''); ?>

или

Пример 2: Получение заголовка поста в переменной

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

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

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

Пример 3: Вывод заголовка с текстом перед ним

Изменения

• С версии 0.71: Введена функция.

Код функции the_title() в WP 6.7.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;
    }
}

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

• get_admin_page_title()
• get_the_archive_title()
• get_the_title()
• single_month_title()
• single_post_title()
• single_term_title()
• the_archive_title()
• the_title_attribute()
• wp_get_document_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()
• get_the_excerpt()
• get_the_ID()
• get_the_modified_date()
• get_the_modified_time()
• get_the_permalink()
• get_the_time()
• get_the_title_rss()
• has_excerpt()
• post_password_required()
• register_post_status()
• the_author()
• the_content()
• the_date()
• the_excerpt()
• the_excerpt_rss()
• the_ID()
• the_modified_date()
• the_permalink()
• the_time()

Другие функции для работы с постами и страницами

• body_class()
• get_post_format()
• has_post_parent()
• have_posts()
• in_the_loop()
• next_image_link()
• next_post_link()
• next_posts_link()
• post_class()
• posts_nav_link()
• previous_image_link()
• previous_post_link()
• previous_posts_link()
• the_category()
• the_modified_author()
• the_post()
• the_post_navigation()
• the_search_query()
• the_shortlink()
• the_tags()
• wp_get_shortlink()
• wp_link_pages()