get_category_parents() WP 1.2.0

Отримує список батьківських категорій цієї категорії. Список виводиться у порядку вкладеності.

Можна вказати щоб назви батьківських категорій були посиланнями на самі категорії (щось на кшталт хлібних крихт).

З версії 4.8 функція стала обгорткою для get_term_parents_list() . А четвертий параметр було скасовано.

Працює на основі:
get_term_parents_list()
Основа для:
get_the_category_list()

Хуків немає.

Повертає

Строку|WP_Error. HTML-код, список батьківських категорій. Або об’єкт WP_Error.

Використання

$cat_parents = get_category_parents( $id, $link, $separator, $nicename );
$id
(число) (обов’язковий)
ID категорії, для якої потрібно вивести батьківську категорію.
$link
(логічний)
true – виведе список батьківських категорій у вигляді посилань на сторінки категорій.

false – будуть виведені назви.


Типово: false
$separator
(рядок)
Розділювач між назвами.


За замовчуванням: ‘/’
$nicename
(логічний)
true – виведе альтернативні назви (слаги) категорій (які використовуються в УРЛах)

false – виїде реальні назви.


Типово: false

Приклади

0

#1 Виведемо батьківські категорії категорії 10

У вигляді посилань розділених знаком ”’. Посилання на категорію 10 також буде виведено.

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

#2 Отримаємо топовий батьківський елемент для вкладеного елемента

Потрібно одержати перший (кореневий) батьківський елемент (термін) таксономії до поточного елемента. Тобто. у нас є елемент таксономії, а нам потрібно отримати найвищий елемент цього терміну з ієрархії.

Відповідь дивіться у питанні: Як отримати елемент таксономії верхнього рівня, в якому знаходиться зазначений запис (пост)?

список змін

З версії 1.2.0Введено.
З версії 4.8.0$visited parameter був deprecated і renamed to $deprecated .

Код get_category_parents() WP 6.0.2

function get_category_parents( $category_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( $category_id, 'category', $args );
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *