THE_ARCHIVE_TITLE() │ WP 4.1.0

Функция the_archive_title() выводит заголовок архивной страницы, основываясь на типе страницы (тег, термин, категория, дата).

Эта функция используется для получения или отображения заголовка текущего термина, даты, типа поста, формата поста или архива автора.

Как использовать

• Используйте get_the_archive_title(), чтобы получить заголовок для обработки в переменной.
• Используйте the_archive_description(), чтобы отобразить описание категории, тега, термина или автора.

Возврат

Функция ничего не возвращает (null).

Синтаксис

the_archive_title( $before, $after );

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

Примеры

Пример 1: Вывод заголовка для архивных страниц

Предположим, у нас есть шаблонный файл index.php, который обрабатывает все архивные страницы, и нам нужно задать для каждой из них разный заголовок, например:

• Если категория, то: "Категория: оптимизация".
• Если тег, то: "Тег: программирование".
• Если архив по году, то: "Год: 2024".

Ранее для этого использовались условные конструкции if ... else ..., но теперь мы можем использовать одну строку:

Пример 2: Удаление префиксов "Категория:", "Тег:" и т.д. на архивной странице

С версии WP 5.5 мы можем сделать это с помощью хука get_the_archive_title_prefix:

// Удаляет "Категория:", "Тег:", "Автор:" и т.д. из заголовка архива
add_filter( 'get_the_archive_title_prefix', '__return_empty_string' );

Для версий до WP 5.5 можно использовать следующий способ:

// Удаляет "Категория:", "Тег:" и т.д. из заголовка архива
add_filter( 'get_the_archive_title', function( $title ){
    return preg_replace( '~^[^:]+: ~', '', $title );
} );

Пример 3: Дополнительные примеры

Для дополнительных примеров можно обратиться к функции get_the_archive_title().

Примечания

• Не забывайте о функции get_the_archive_title().

Изменения

Функция была введена в версии 4.1.0.

Код функции the_archive_title()

function the_archive_title( $before = '', $after = '' ) {
    $title = get_the_archive_title();
    if ( ! empty( $title ) ) {
        echo $before . $title . $after;
    }
}

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

Архивы (постов)

• get_post_type_archive_link()
• get_the_archive_title()
• is_archive()
• is_post_type_archive()
• post_type_archive_title()
• WP_Widget_Archives()

Заголовки (страницы постов)

• get_admin_page_title()
• get_the_title()
• single_month_title()
• single_post_title()
• single_term_title()
• the_title()
• the_title_attribute()
• wp_get_document_title()

Основные функции

• bloginfo()
• get_header()
• get_footer()
• is_home()
• wp_head()
• wp_footer()

Эта статья поможет вам лучше разобраться в использовании функции the_archive_title() в WordPress.