# wp_insert_category()

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

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

## Сигнатура

```php
wp_insert_category( array $catarr, bool $wp_error = false ): int|WP_Error
```

## Описание

Обновляет существующую категорию или создаёт новую категорию.

## Параметры

- `$catarr` `array` — обязательный. Массив аргументов для вставки новой категории.
  
  cat_ID intID категории. Ненулевое значение обновляет существующую категорию.
  
  Значение по умолчанию 0.
  
  taxonomy stringСлаг таксономии. Значение по умолчанию 'category'.
  
  cat_name stringИмя категории. По умолчанию пусто.
  
  category_description stringОписание категории. По умолчанию пусто.
  
  category_nicename stringОтображаемое (nice) имя категории. По умолчанию пусто.
  
  category_parent int|stringID родительской категории. По умолчанию пусто.
- `$wp_error` `bool` — необязательный, по умолчанию `false`. Значение по умолчанию: false

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

`int|WP_Error` — WP_Error $wp_error

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

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

```php
function wp_insert_category( $catarr, $wp_error = false ) {
	$cat_defaults = array(
		'cat_ID'               => 0,
		'taxonomy'             => 'category',
		'cat_name'             => '',
		'category_description' => '',
		'category_nicename'    => '',
		'category_parent'      => '',
	);
	$catarr       = wp_parse_args( $catarr, $cat_defaults );

	if ( '' === trim( $catarr['cat_name'] ) ) {
		if ( ! $wp_error ) {
			return 0;
		} else {
			return new WP_Error( 'cat_name', __( 'You did not enter a category name.' ) );
		}
	}

	$catarr['cat_ID'] = (int) $catarr['cat_ID'];

	// Are we updating or creating?
	$update = ! empty( $catarr['cat_ID'] );

	$name        = $catarr['cat_name'];
	$description = $catarr['category_description'];
	$slug        = $catarr['category_nicename'];
	$parent      = (int) $catarr['category_parent'];
	if ( $parent < 0 ) {
		$parent = 0;
	}

	if ( empty( $parent )
		|| ! term_exists( $parent, $catarr['taxonomy'] )
		|| ( $catarr['cat_ID'] && term_is_ancestor_of( $catarr['cat_ID'], $parent, $catarr['taxonomy'] ) ) ) {
		$parent = 0;
	}

	$args = compact( 'name', 'slug', 'parent', 'description' );

	if ( $update ) {
		$catarr['cat_ID'] = wp_update_term( $catarr['cat_ID'], $catarr['taxonomy'], $args );
	} else {
		$catarr['cat_ID'] = wp_insert_term( $catarr['cat_name'], $catarr['taxonomy'], $args );
	}

	if ( is_wp_error( $catarr['cat_ID'] ) ) {
		if ( $wp_error ) {
			return $catarr['cat_ID'];
		} else {
			return 0;
		}
	}
	return $catarr['cat_ID']['term_id'];
}
```

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

- 3.0.0 — The 'taxonomy' argument was added.
- 2.5.0 — $wp_error parameter was added.
- 2.0.0 — Introduced.

## Связанные

Использует: [`wp_update_term`](https://chugunov.pro/api-wordpress/functions/wp_update_term/), [`wp_insert_term`](https://chugunov.pro/api-wordpress/functions/wp_insert_term/), [`term_exists`](https://chugunov.pro/api-wordpress/functions/term_exists/), [`term_is_ancestor_of`](https://chugunov.pro/api-wordpress/functions/term_is_ancestor_of/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/), [`is_wp_error`](https://chugunov.pro/api-wordpress/functions/is_wp_error/), `WP_Error::__construct`.
Используется в: [`wp_create_category`](https://chugunov.pro/api-wordpress/functions/wp_create_category/), [`wp_update_category`](https://chugunov.pro/api-wordpress/functions/wp_update_category/), [`wp_insert_category`](https://chugunov.pro/api-wordpress/functions/wp_insert_category/), `wp_xmlrpc_server::wp_newCategory`.

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