get_the_archive_description() │ WP 4.1.0

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

Предназначен для использования на страницах архивов элементов таксономий (включая рубрики и метки), архивов типов записей или архива автора.

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

Используйте обертку the_archive_description(), чтобы сразу вывести результат на экран.

Работает на основе: get_the_author_meta(), term_description()

Основа для: the_archive_description()

Хуки из функции

get_the_archive_description

Возвращает

Строку. Описание для страницы архива.

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

$desc = get_the_archive_description();

Примеры

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

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

$description = get_the_archive_description();

if ( $description ) {
	echo "The description: $description";
}

Но лучше для таких целей использовать обертку для этой функции: the_archive_description(). В данном случае можно просто использовать параметр $before чтобы добавить текст перед описанием.

Заметки

Смотрите: term_description()

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

С версии 4.1.0	Введена.
С версии 4.7.0	Added support for author archives.
С версии 4.9.0	Added support for post type archives.

Код `get_the_archive_description() get the archive description` ^{WP 6.7.1}

wp-includes/general-template.php

function get_the_archive_description() {
	if ( is_author() ) {
		$description = get_the_author_meta( 'description' );
	} elseif ( is_post_type_archive() ) {
		$description = get_the_post_type_description();
	} else {
		$description = term_description();
	}

	/**
	 * Filters the archive description.
	 *
	 * @since 4.1.0
	 *
	 * @param string $description Archive description to be displayed.
	 */
	return apply_filters( 'get_the_archive_description', $description );
}