# term_is_ancestor_of()

URL: https://chugunov.pro/api-wordpress/functions/term_is_ancestor_of/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.4.0.

## Сигнатура

```php
term_is_ancestor_of( int|object $term1, int|object $term2, string $taxonomy ): bool
```

## Описание

Для обоих параметров можно использовать либо ID, либо объект термина.

## Параметры

- `$term1` `int|object` — обязательный. ID или объект для проверки, является ли он родительским термином.
- `$term2` `int|object` — обязательный. Дочерний термин.
- `$taxonomy` `string` — обязательный. Имя таксономии, которой принадлежат $term1 и $term2.

## Возвращаемое значение

`bool` — $term2 $term1

## Исходный код

Файл: `wp-includes/taxonomy.php:1685`

```php
function term_is_ancestor_of( $term1, $term2, $taxonomy ) {
	if ( ! isset( $term1->term_id ) ) {
		$term1 = get_term( $term1, $taxonomy );
	}
	if ( ! isset( $term2->parent ) ) {
		$term2 = get_term( $term2, $taxonomy );
	}

	if ( empty( $term1->term_id ) || empty( $term2->parent ) ) {
		return false;
	}
	if ( $term2->parent === $term1->term_id ) {
		return true;
	}

	return term_is_ancestor_of( $term1, get_term( $term2->parent, $taxonomy ), $taxonomy );
}
```

## История изменений

- 3.4.0 — Introduced.

## Связанные

Использует: [`term_is_ancestor_of`](https://chugunov.pro/api-wordpress/functions/term_is_ancestor_of/), [`get_term`](https://chugunov.pro/api-wordpress/functions/get_term/).
Используется в: [`wp_insert_category`](https://chugunov.pro/api-wordpress/functions/wp_insert_category/), [`cat_is_ancestor_of`](https://chugunov.pro/api-wordpress/functions/cat_is_ancestor_of/), [`term_is_ancestor_of`](https://chugunov.pro/api-wordpress/functions/term_is_ancestor_of/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/term_is_ancestor_of/