WordPress как на ладони
wordpress jino

get_category_parents() WP 1.2.0

Получает список родительских категорий текущей категории. Список выводиться в порядке вложенности.

Можно указать чтобы названия родительских категорий были ссылками на сами категории (нечто вроде хлебных крошек).

С версии 4.8 функция стала обёрткой для get_term_parents_list(). А 4-ый параметр был отменен.

Используется в: get_the_category_list().
Работает на основе: get_term_parents_list()

Хуков нет.

Возвращает

Строка/WP_Error. HTML код, список родительских категорий. Или объект WP_Error.

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

$cat_parents = get_category_parents( $id, $link, $separator );
$id(число) (обязательный)
ID категории, для которой нужно вывести родительские категории.
$link(логический)
true - выведет список родительских категорий в виде ссылок на страницы категорий. False - будут выведены названия.
По умолчанию: false
$separator(строка)
Разделитель между названиями.
По умолчанию: '/'
$deprecated(логический)
Параметр $nicename был отменен с версии 4.8.
true - выведет альтернативные названия (слаги) категорий (которые используются в УРЛах), а false - выедет реальные названия.
По умолчанию: false

Примеры

#1. Выведем родительские категории категории 10

В виде ссылок разделенных знаком ' » '. Ссылка на категорию 10 так же будет выведена.

<?php echo get_category_parents( 10, true, ' » '); ?>

#2. Получим самый родительский элемент для указанной таксономии и вложенного элемента

Нам нужно получить первый родительский элемент (корневой термин), который относится к известному вложенному элементу таксономии.

Ответ в вопросе: Как получить элемент таксономии верхнего уровня в котором находится указанная запись (пост)?

Код get category parents: wp-includes/category-template.php VER 4.9.1

<?php
function get_category_parents( $id, $link = false, $separator = '/', $nicename = false, $deprecated = array() ) {

	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, '4.8.0' );
	}

	$format = $nicename ? 'slug' : 'name';

	$args = array(
		'separator' => $separator,
		'link'      => $link,
		'format'    => $format,
	);

	return get_term_parents_list( $id, 'category', $args );
}

Cвязанные функции

Из метки: Связи

Еще из раздела: Рубрики

get_category_parents 2 комментария
  • Андрей cайт: www.mnogoedy.ru

    Имеем - категория-1 -> категория-2 -> запись.
    Такой вопрос - можно ли сразу получить ID "категория-1" (самый верхний уровень)?
    Есть ли такая функция или надо перебором?

    Нужно для того, чтобы возле заголовка каждой записи стояла иконка принадлежности к определенному глобальному разделу сайта (таких пока 3).

    Ответить6 лет назад #

Здравствуйте, !

Ваш комментарий