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 категории при нахождении на странице архивов этой категории.

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

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

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

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

Миша

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

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

Чтобы оставить комментарий, пожалуйста, зарегистрируйтесь или войдите.