the_archive_description() │ WP 4.1.0

Выводит на экран описание для страниц архивов: типов записей, меток, рубрик, элементов таксономий или архив автора.

Удобно использовать для комплексного вывода описания архива в темах.

На странице автора описание берется из поля «Биография» (description). У элементов таксономии их поля «Описание» (description). У типов записей из функции get_the_post_type_description().

Работает на основе: get_the_archive_description()

Хуков нет.

Возвращает

null. Ничего. Выводит HTML код на экран.

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

the_archive_description( $before, $after );
$before(строка)
Текст перед описанием. Можно указать HTML.
По умолчанию: ''
$after(строка)
Текст после описания. Можно указать HTML.
По умолчанию: ''

Примеры

0

#1 Выведем описание на любой странице архива (кроме архива по датам)

Допустим, нужно разом вывести описание для: меток, рубрик, таксономий, авторов.

У архивов по дате описание нет, потому что оно нигде в админке не заполняется и хранить его в общем-то негде, и вообще архив по датам очень редко используется на сайтах. Подробнее смотрите код get_the_archive_description().

<?php the_archive_description(); ?>

Заметки

Список изменений

С версии 4.1.0 Введена.

Код the_archive_description() WP 6.7.1

wp-includes/general-template.php 
function the_archive_description( $before = '', $after = '' ) {
	$description = get_the_archive_description();
	if ( $description ) {
		echo $before . $description . $after;
	}
}

Описание (post term description)

Архивы

Основные