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 лично, у себя в блогах и на курсах в Санкт-Петербурге. Умеет просто объяснять сложные вещи, делает это красиво. Организовывает неплохие WordCamp's, но совсем не умеет слушать чужие доклады.

Добавить комментарий

%d такие блоггеры, как: