the_archive_title()
Выводит на экран заголовок архивной страницы, на основе типа страницы (метка, рубрика, дата).
Используется для отображения заголовка текущего термина
, даты
, типа поста
, формата поста
или архива автора
.
-
Используйте get_the_archive_title(), чтобы получить заголовок, а не выводить его на экран.
- Используйте the_archive_description(), чтобы показать описание: категории, тега, термина, автора.
Хуков нет.
Возвращает
null
.
Использование
<?php the_archive_title( $before, $after ); ?>
- $before(строка)
- Текст перед заголовком. Можно указать HTML теги.
По умолчанию: '' - $after(строка)
- Текст после заголовка. Можно указать HTML теги.
По умолчанию: ''
Примеры
#1 Удалим префикс «Рубрика:», «Метка:» на странице архивов
Для этого используем следующий хук:
## Удаляет "Рубрика: ", "Метка: " и т.д. из заголовка архива add_filter( 'get_the_archive_title', function( $title ){ return preg_replace('~^[^:]+: ~', '', $title ); });
#2 Выведем заголовок для архивных страниц
Раньше (до 4.1), чтобы в одном файле (например index.php) вывести заголовок для разных архивных страниц (метка, рубрика...) нужно было с помощью условных тегов проверять какая это страница и выводить текст для меток один, для рубрик другой. Для этого мы использовали конструкцию if ... else .... Теперь вся эта логика содержится в функции the_archive_title():
<?php the_archive_title() ?>
Выведет на экран:
Если категория: "Категория: мелодраммы"
Если метка: "Метка: море"
Если архив по году, то: "Год: 2104"
Заметки
- Смотрите: get_the_archive_title()
Список изменений
С версии 4.1.0 | Введена. |
Код the_archive_title() the archive title WP 6.3.1
function the_archive_title( $before = '', $after = '' ) { $title = get_the_archive_title(); if ( ! empty( $title ) ) { echo $before . $title . $after; } }