# pre_unschedule_hook

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

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

## Сигнатура

```php
apply_filters( 'pre_unschedule_hook', null|int|false|WP_Error $pre, string $hook, bool $wp_error )
```

## Описание

Возврат значения, отличного от null, прервёт обычный процесс отмены планирования, из-за чего функция вернёт отфильтрованное значение.
Для плагинов, заменяющих wp-cron, верните количество успешно снятых с планирования событий (ноль, если с хуком не было зарегистрировано ни одного события). Если отмена планирования одного или нескольких событий завершилась неудачей, верните объект WP_Error или false в зависимости от значения параметра $wp_error.

## Параметры

- `$pre` `null|int|false|WP_Error` — обязательный. Значение, которое нужно вернуть вместо этого. По умолчанию null для продолжения отмены планирования хука.
- `$hook` `string` — обязательный. Хук-действие, выполнение которого будет отменено.
- `$wp_error` `bool` — обязательный. Возвращать ли WP_Error в случае сбоя.

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

Значение, которое нужно вернуть вместо этого. По умолчанию null для продолжения отмены планирования хука.

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

Файл: `wp-includes/cron.php:700`

```php
$pre = apply_filters( 'pre_unschedule_hook', null, $hook, $wp_error );
```

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

- 5.7.0 — The $wp_error parameter was added, and a WP_Error object can now be returned.
- 5.1.0 — Introduced.

## Связанные

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

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