# delete_user_setting()

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

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

## Сигнатура

```php
delete_user_setting( string $names ): bool|null
```

## Описание

Удаление настроек сбросит их к значениям по умолчанию.
Эту функцию необходимо использовать до начала любого вывода, так как она вызывает setcookie().

## Параметры

- `$names` `string` — обязательный. Имя или массив имён удаляемых настроек.

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

`bool|null`

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

Файл: `wp-includes/option.php:1796`

```php
function delete_user_setting( $names ) {
	if ( headers_sent() ) {
		return false;
	}

	$all_user_settings = get_all_user_settings();
	$names             = (array) $names;
	$deleted           = false;

	foreach ( $names as $name ) {
		if ( isset( $all_user_settings[ $name ] ) ) {
			unset( $all_user_settings[ $name ] );
			$deleted = true;
		}
	}

	if ( $deleted ) {
		return wp_set_all_user_settings( $all_user_settings );
	}

	return false;
}
```

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

- 2.7.0 — Introduced.

## Связанные

Использует: [`get_all_user_settings`](https://chugunov.pro/api-wordpress/functions/get_all_user_settings/), [`wp_set_all_user_settings`](https://chugunov.pro/api-wordpress/functions/wp_set_all_user_settings/).
Используется в: [`default_password_nag_handler`](https://chugunov.pro/api-wordpress/functions/default_password_nag_handler/), [`default_password_nag_edit_user`](https://chugunov.pro/api-wordpress/functions/default_password_nag_edit_user/).

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