# apply_filters_deprecated()

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

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

> Устаревший элемент.

## Сигнатура

```php
apply_filters_deprecated( string $hook_name, array $args, string $version, string $replacement = '', string $message = '' ): mixed
```

## Описание

Когда хук-фильтр становится устаревшим, вызов apply_filters() заменяется на apply_filters_deprecated() , который выдаёт уведомление об устаревании, а затем запускает исходный хук-фильтр.
Примечание: значение и дополнительные аргументы, передаваемые в исходный вызов apply_filters() , нужно передать здесь в $args в виде массива. Например:

// Старый фильтр.
return apply_filters( 'wpdocs_filter', $value, $extra_arg );

// Устаревший вариант.
return apply_filters_deprecated( 'wpdocs_filter', array( $value, $extra_arg ), '4.9.0', 'wpdocs_new_filter' );См. also_deprecated_hook()

## Параметры

- `$hook_name` `string` — обязательный. Имя хука-фильтра.
- `$args` `array` — обязательный. Массив дополнительных аргументов функции, передаваемых в apply_filters() .
- `$version` `string` — обязательный. Версия WordPress, в которой хук стал устаревшим.
- `$replacement` `string` — необязательный, по умолчанию `''`. Хук, который следовало использовать.
- `$message` `string` — необязательный, по умолчанию `''`. Сообщение об изменении.

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

`mixed`

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

Файл: `wp-includes/plugin.php:722`

```php
function apply_filters_deprecated( $hook_name, $args, $version, $replacement = '', $message = '' ) {
	if ( ! has_filter( $hook_name ) ) {
		return $args[0];
	}

	_deprecated_hook( $hook_name, $version, $replacement, $message );

	return apply_filters_ref_array( $hook_name, $args );
}
```

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

- 4.6.0 — Introduced.

## Связанные

Использует: [`_deprecated_hook`](https://chugunov.pro/api-wordpress/functions/_deprecated_hook/), [`has_filter`](https://chugunov.pro/api-wordpress/functions/has_filter/), [`apply_filters_ref_array`](https://chugunov.pro/api-wordpress/functions/apply_filters_ref_array/).
Используется в: [`get_block_editor_settings`](https://chugunov.pro/api-wordpress/functions/get_block_editor_settings/), [`block_editor_rest_api_preload`](https://chugunov.pro/api-wordpress/functions/block_editor_rest_api_preload/), [`get_allowed_block_types`](https://chugunov.pro/api-wordpress/functions/get_allowed_block_types/), [`get_block_categories`](https://chugunov.pro/api-wordpress/functions/get_block_categories/), [`_wp_privacy_send_request_confirmation_notification`](https://chugunov.pro/api-wordpress/functions/_wp_privacy_send_request_confirmation_notification/), [`_wp_privacy_send_erasure_fulfillment_notification`](https://chugunov.pro/api-wordpress/functions/_wp_privacy_send_erasure_fulfillment_notification/), `WP_Privacy_Policy_Content::get_default_content`, `WP_Site::get_details`, `WP_REST_Server::serve_request`, [`login_header`](https://chugunov.pro/api-wordpress/functions/login_header/), [`validate_another_blog_signup`](https://chugunov.pro/api-wordpress/functions/validate_another_blog_signup/), `WP_Screen::render_screen_meta`, [`wp_save_image_file`](https://chugunov.pro/api-wordpress/functions/wp_save_image_file/), [`image_edit_apply_changes`](https://chugunov.pro/api-wordpress/functions/image_edit_apply_changes/), [`wp_stream_image`](https://chugunov.pro/api-wordpress/functions/wp_stream_image/), [`WP_Image_Editor`](https://chugunov.pro/api-wordpress/functions/wp_image_editor/), [`media_buttons`](https://chugunov.pro/api-wordpress/functions/media_buttons/), `WP_Terms_List_Table::prepare_items`, [`map_meta_cap`](https://chugunov.pro/api-wordpress/functions/map_meta_cap/), `WP::build_query_string`, `WP_Http::_get_first_available_transport`, [`get_posts_by_author_sql`](https://chugunov.pro/api-wordpress/functions/get_posts_by_author_sql/), `WP_Rewrite::mod_rewrite_rules`, `WP_Rewrite::rewrite_rules`, [`get_blog_details`](https://chugunov.pro/api-wordpress/functions/get_blog_details/), `_WP_Editors::editor`.

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