the_archive_title()
Виводить на екран заголовок архівної сторінки на основі типу сторінки (мітка, рубрика, дата).
Використовується для відображення заголовка поточного термина, даты, типа постаабо формата постаархіву автора.
Використовуйте get_the_archive_title() , щоб отримати заголовок, а не виводити його на екран.
- Використовуйте the_archive_description() , щоб показати опис: категорії, теги, терміни, автори.
get_the_archive_title()
Хуків немає.
Повертає
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.0.2
function the_archive_title( $before = '', $after = '' ) {
$title = get_the_archive_title();
if ( ! empty( $title ) ) {
echo $before . $title . $ after;
}
}