функция
since 4.8.0
get_term_parents_list()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
get_term_parents_list( int $term_id, string $taxonomy, string|array $args = array() ): string|WP_Error
Описание
Получает родительские термины с разделителем.
Параметры
$term_id
int
обязательный
ID термина.
$taxonomy
string
обязательный
Имя таксономии.
$args
string|array
необязательный
= array()
Массив необязательных аргументов.
format stringИспользовать для отображения имена терминов или слаги. Принимает 'name' или 'slug'.
Значение по умолчанию 'name'.
separator stringРазделитель между терминами. Значение по умолчанию '/'.
link boolНужно ли оформлять как ссылку. Значение по умолчанию true.
inclusive boolВключать сам термин, для которого получаются родители. Значение по умолчанию true.
Возвращаемое значение
string|WP_Error
WP_Error
Исходный код
wp-includes/category-template.php:1398
function get_term_parents_list( $term_id, $taxonomy, $args = array() ) {
$list = '';
$term = get_term( $term_id, $taxonomy );
if ( is_wp_error( $term ) ) {
return $term;
}
if ( ! $term ) {
return $list;
}
$term_id = $term->term_id;
$defaults = array(
'format' => 'name',
'separator' => '/',
'link' => true,
'inclusive' => true,
);
$args = wp_parse_args( $args, $defaults );
foreach ( array( 'link', 'inclusive' ) as $bool ) {
$args[ $bool ] = wp_validate_boolean( $args[ $bool ] );
}
$parents = get_ancestors( $term_id, $taxonomy, 'taxonomy' );
if ( $args['inclusive'] ) {
array_unshift( $parents, $term_id );
}
foreach ( array_reverse( $parents ) as $term_id ) {
$parent = get_term( $term_id, $taxonomy );
$name = ( 'slug' === $args['format'] ) ? $parent->slug : $parent->name;
if ( $args['link'] ) {
$list .= '<a href="' . esc_url( get_term_link( $parent->term_id, $taxonomy ) ) . '">' . $name . '</a>' . $args['separator'];
} else {
$list .= $name . $args['separator'];
}
}
return $list;
}
История изменений
| Версия | Описание |
|---|---|
| 4.8.0 | Introduced. |

