# pre_schedule_event

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

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

## Сигнатура

```php
apply_filters( 'pre_schedule_event', null|bool|WP_Error $result, object $event, bool $wp_error )
```

## Описание

Возврат значения, отличного от null, прервёт добавление события в массив cron, из-за чего функция вернёт отфильтрованное значение.
Через этот фильтр проходят как одиночные, так и повторяющиеся события; у одиночных событий $event->schedule равно false, тогда как у повторяющихся оно установлено в периодичность из wp_get_schedules() . У повторяющихся событий также задан целочисленный интервал повторения в $event->interval.
Для плагинов, заменяющих wp-cron, рекомендуется проверять наличие идентичного события в пределах десяти минут и применять фильтр 'schedule_event', чтобы убедиться, что другой плагин не запретил событие, прежде чем планировать его.
Верните true, если событие было запланировано, false или WP_Error, если нет.

## Параметры

- `$result` `null|bool|WP_Error` — обязательный. Значение, которое нужно вернуть вместо этого. По умолчанию null для продолжения добавления события.
- `$event` `object` — обязательный. Объект, содержащий данные события.
  
  hook stringХук-действие, выполняемый при запуске события.
  
  timestamp intUnix-метка времени (UTC) следующего запуска события.
  
  schedule string|falseКак часто событие должно затем повторяться.
  
  args arrayМассив, содержащий каждый отдельный аргумент, передаваемый функции обратного вызова хука.
  
  interval intНеобязательно. Интервал в секундах для расписания. Присутствует только для повторяющихся событий.
- `$wp_error` `bool` — обязательный. Возвращать ли WP_Error в случае сбоя.

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

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

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

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

```php
$pre = apply_filters( 'pre_schedule_event', null, $event, $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_schedule_event`](https://chugunov.pro/api-wordpress/functions/wp_schedule_event/), [`wp_schedule_single_event`](https://chugunov.pro/api-wordpress/functions/wp_schedule_single_event/).

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