Описание pre_schedule_event
— Action
Хук pre_schedule_event позволяет изменять параметры запланированных событий перед их добавлением в очередь задач. Он срабатывает перед тем, как событие будет запланировано на выполнение, предоставляя возможность изменить параметры или отменить их добавление в очередь
Примеры использования
Пример изменения времени запланированного события:
add_action('pre_schedule_event', function($timestamp, $hook, $args, $schedule) {
if ($hook === 'my_custom_hook') {
$timestamp = strtotime('+1 hour');
}
return $timestamp;
}, 10, 4);
В этом примере мы изменяем время запланированного события, если его хук — my_custom_hook
Пример отмены запланированного события:
add_action('pre_schedule_event', function($timestamp, $hook, $args, $schedule) {
if ($hook === 'my_custom_hook') {
return false; // Отменяем запланированное событие
}
}, 10, 4);
Здесь мы отменяем запланированное событие, если его хук — my_custom_hook
Пример изменения аргументов события:
add_action('pre_schedule_event', function($timestamp, $hook, $args, $schedule) {
if ($hook === 'my_custom_hook') {
$args[] = 'new_argument';
}
return $args;
}, 10, 4);
В этом примере мы добавляем новый аргумент к вызываемому событию, если его хук — my_custom_hook
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить параметры запланированных событий, например, время или аргументы
– Производительность
Следует быть осторожными с изменениями, чтобы не вызывать задержек в выполнении задач
– Предупреждения
Не забывайте проверять, действительно ли нужно изменять параметры, так как это может повлиять на выполнение других функций
Альтернативы
Тип: function
Функция, которая используется для запланирования событий, где можно задать параметры напрямую
Используйте ее, когда вы хотите запланировать событие, не прибегая к хукам
