# update_user_status()

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

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

> Устаревший элемент. Помечен устаревшим с версии 5.3.0.

## Сигнатура

```php
update_user_status( int $id, string $pref, int $value, mixed $deprecated = null ): int
```

## Описание

Ранее использовалась в ядре для пометки пользователя как спама или «ham» (не спам) в режиме мультисайта.
См. alsowp_update_user()

## Параметры

- `$id` `int` — обязательный. Идентификатор пользователя.
- `$pref` `string` — обязательный. Столбец таблицы wp_users, в котором обновляется статус пользователя (предположительно user_status, spam или deleted).
- `$value` `int` — обязательный. Новый статус пользователя.
- `$deprecated` `mixed` — необязательный, по умолчанию `null`. Не используется.

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

`int`

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

Файл: `wp-includes/ms-deprecated.php:710`

```php
function update_user_status( $id, $pref, $value, $deprecated = null ) {
	global $wpdb;

	_deprecated_function( __FUNCTION__, '5.3.0', 'wp_update_user()' );

	if ( null !== $deprecated ) {
		_deprecated_argument( __FUNCTION__, '3.0.2' );
	}

	$wpdb->update( $wpdb->users, array( sanitize_key( $pref ) => $value ), array( 'ID' => $id ) );

	$user = new WP_User( $id );
	clean_user_cache( $user );

	if ( 'spam' === $pref ) {
		if ( $value == 1 ) {
			/** This filter is documented in wp-includes/user.php */
			do_action( 'make_spam_user', $id );
		} else {
			/** This filter is documented in wp-includes/user.php */
			do_action( 'make_ham_user', $id );
		}
	}

	return $value;
}
```

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

- 5.3.0 — Deprecated. Use wp_update_user()
- 3.0.2 — Deprecated fourth argument.
- 3.0.0 — Introduced.

## Связанные

Использует: `WP_User::__construct`, [`clean_user_cache`](https://chugunov.pro/api-wordpress/functions/clean_user_cache/), `wpdb::update`, [`sanitize_key`](https://chugunov.pro/api-wordpress/functions/sanitize_key/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/), [`_deprecated_argument`](https://chugunov.pro/api-wordpress/functions/_deprecated_argument/), [`do_action`](https://chugunov.pro/api-wordpress/functions/do_action/).

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