# wp_check_term_hierarchy_for_loops()

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

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

## Сигнатура

```php
wp_check_term_hierarchy_for_loops( int $parent_term, int $term_id, string $taxonomy ): int
```

## Описание

Предотвращает образование циклов и разрывает те, что находит.
Прикреплена к фильтру «wp_update_term_parent».

## Параметры

- `$parent_term` `int` — обязательный. term_id родителя для проверяемого термина.
- `$term_id` `int` — обязательный. Проверяемый термин.
- `$taxonomy` `string` — обязательный. Таксономия проверяемого термина.

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

`int`

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

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

```php
function wp_check_term_hierarchy_for_loops( $parent_term, $term_id, $taxonomy ) {
	// Nothing fancy here - bail.
	if ( ! $parent_term ) {
		return 0;
	}

	// Can't be its own parent.
	if ( $parent_term === $term_id ) {
		return 0;
	}

	// Now look for larger loops.
	$loop = wp_find_hierarchy_loop( 'wp_get_term_taxonomy_parent_id', $term_id, $parent_term, array( $taxonomy ) );
	if ( ! $loop ) {
		return $parent_term; // No loop.
	}

	// Setting $parent_term to the given value causes a loop.
	if ( isset( $loop[ $term_id ] ) ) {
		return 0;
	}

	// There's a loop, but it doesn't contain $term_id. Break the loop.
	foreach ( array_keys( $loop ) as $loop_member ) {
		wp_update_term( $loop_member, $taxonomy, array( 'parent' => 0 ) );
	}

	return $parent_term;
}
```

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

- 3.1.0 — Introduced.

## Связанные

Использует: [`wp_find_hierarchy_loop`](https://chugunov.pro/api-wordpress/functions/wp_find_hierarchy_loop/), [`wp_update_term`](https://chugunov.pro/api-wordpress/functions/wp_update_term/).

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