get_term_parents_list()

Позволяет получить список родительских элементов указанного элемента таксономии в соответствующем порядке.

Эта функцию удобно использовать при создании хлебных крошек.

Возвращает:

• список родительских элементов – в случае успеха,
• объект WP_Error, если пытаемся получить термины несуществующей таксономии или в качестве параметра $term_id передано пустое значение,
• пустую строку, если у термина нет родительских элементов.

get_term_parents_list( $term_id, $taxonomy, $args = array() )

Параметры

$term_id

(целое) ID термина, родителей которого будем получать.

$taxonomy

(строка) Название таксономии терминов.

$args

(массив) Дополнительные аргументы, а именно:

format

(строка)

• name – в качестве текста ссылок будут использоваться имена терминов (по умолчанию).
• slug – в качестве текста ссылок будут использоваться ярлыки терминов.

separator

(строка) Разделитель между терминами.

link

(логическое)

• true – выводить термины в виде ссылок (по умолчанию).
• false – не оборачивать названия/ярлыки терминов в ссылки.

inclusive

(логическое)

• true – выводить и текущий термин тоже (по умолчанию).
• false – исключить текущий термин из списка.

Примеры

Базовый пример:

// выводим список родительских рубрик текущей категории, разделённых слэшами
echo get_term_parents_list( 
	get_queried_object_id(), 
	'category', 
	array(
		'separator' => ' / '
	)
);
 
/*
<a href="http:// ... /ryukzaki">Рюкзаки</a> / <a href="http:// ... /ryukzaki/brendy">Бренды</a> / <a href="http:// ... /ryukzaki/brendy/kenzo">Kenzo</a> /
*/

Функцию get_queried_object_id() мы здесь использовали для получения ID категории при нахождении на странице архивов этой категории.

В админке выглядит допустим примерно так:

Тот же самый пример, но с другими значениями параметра $args:

// выводим список родительских рубрик текущей категории, разделённых слэшами
echo get_term_parents_list( 
	get_queried_object_id(), 
	'category', 
	array(
		'separator' => ', ',
		'link' => false,
		'inclusive' => false
	)
);
 
/*
Рюкзаки, Бренды, 
*/