get_category_parents()
Отримує список батьківських категорій цієї категорії. Список виводиться у порядку вкладеності.
Можна вказати щоб назви батьківських категорій були посиланнями на самі категорії (щось на кшталт хлібних крихт).
З версії 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
Приклади
#1 Виведемо батьківські категорії категорії 10
У вигляді посилань розділених знаком ”’. Посилання на категорію 10 також буде виведено.
<?php echo get_category_parents( 10, true, ' » '); ?>
#2 Отримаємо топовий батьківський елемент для вкладеного елемента
Потрібно одержати перший (кореневий) батьківський елемент (термін) таксономії до поточного елемента. Тобто. у нас є елемент таксономії, а нам потрібно отримати найвищий елемент цього терміну з ієрархії.
Відповідь дивіться у питанні: Як отримати елемент таксономії верхнього рівня, в якому знаходиться зазначений запис (пост)?
список змін
| З версії 1.2.0 | Введено. |
| З версії 4.8.0 | $visited parameter був deprecated і renamed to $deprecated . |
Код get_category_parents() 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 );
}