get_term_parents_list()

4.8.0 wp-includes / category-template.php / Кодекс WordPress

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

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

Возвращает:

список родительских элементов – в случае успеха,
объект 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 категории при нахождении на странице архивов этой категории.

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

Пример использования функции get_term_parents_list() в WordPress

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

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

Кодекс WordPress: Таксономии: add_term_meta(), edit_term_link(), get_ancestors(), get_edit_term_link(), get_taxonomies(), get_taxonomy(), get_term(), get_term_by(), get_term_children(), get_term_field(), get_term_link(), get_term_meta(), get_term_parents_list(), get_terms(), get_the_term_list(), get_the_terms(), is_object_in_term(), is_tax(), is_taxonomy_hierarchical(), register_taxonomy(), register_taxonomy_for_object_type(), sanitize_term(), sanitize_term_field(), single_term_title(), taxonomy_exists(), term_description(), term_exists(), term_is_ancestor_of(), the_terms(), unregister_taxonomy(), unregister_taxonomy_for_object_type(), update_term_meta(), wp_count_terms(), wp_delete_term(), wp_get_object_terms(), wp_get_post_terms(), wp_get_term_taxonomy_parent_id(), wp_insert_term(), wp_set_object_terms(), wp_update_term()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Параметры
Примеры