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;
}
}