# widget_update_callback

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

Тип: хук-фильтр.
Появился в версии: 2.8.0.

## Сигнатура

```php
apply_filters( 'widget_update_callback', array $instance, array $new_instance, array $old_instance, WP_Widget $widget )
```

## Описание

Возврат false фактически лишает виджет возможности обновить настройки.

## Параметры

- `$instance` `array` — обязательный. Настройки текущего экземпляра виджета.
- `$new_instance` `array` — обязательный. Массив новых настроек виджета.
- `$old_instance` `array` — обязательный. Массив прежних настроек виджета.
- `$widget` `WP_Widget` — обязательный. Текущий экземпляр виджета.

## Фильтруемое значение

Настройки текущего экземпляра виджета.

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

Файл: `wp-includes/class-wp-widget.php:476`

```php
$instance = apply_filters( 'widget_update_callback', $instance, $new_instance, $old_instance, $this );
```

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

- 2.8.0 — Introduced.

## Связанные

Используется в: `WP_REST_Widget_Types_Controller::encode_form_data`, `WP_Widget::update_callback`.

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