функция
Устаревший since 1.2.0
get_category_parents()
Устаревшее.
Помечено устаревшим с версии 4.8.0.
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
get_category_parents( int $category_id, bool $link = false, string $separator = '/', bool $nicename = false, array $deprecated = array() ): string|WP_ErrorОписание
Получает родительские рубрики с разделителем.
Параметры
$category_id
int
обязательный
Идентификатор рубрики.
$link
bool
необязательный
= false
Форматировать ли со ссылкой.
$separator
string
необязательный
= '/'
Чем разделять рубрики. Значение по умолчанию '/'.
$nicename
bool
необязательный
= false
Использовать ли удобочитаемое имя для отображения.
$deprecated
array
необязательный
= array()
Не используется.
Возвращаемое значение
string|WP_Error
WP_Error
Исходный код
wp-includes/category-template.php:47
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 );
}История изменений
| Версия | Описание |
|---|---|
| 4.8.0 | The $visited parameter was deprecated and renamed to $deprecated. |
| 1.2.0 | Introduced. |
