Описание woocommerce_order_is_pending_statuses
— Filter
Хук woocommerce_order_is_pending_statuses позволяет изменять массив статусов заказов, которые считаются ‘ожидающими’ в WooCommerce. Он срабатывает при определении статусов заказов, ожидающих обработки, и позволяет расширять или изменять этот список для своих нужд
Примеры использования
Пример добавления нового статуса ‘awaiting-payment’ в массив ожидающих статусов:
add_filter('woocommerce_order_is_pending_statuses', function($pending_statuses) {
$pending_statuses[] = 'awaiting-payment';
return $pending_statuses;
});
В этом примере мы добавляем новый статус ‘awaiting-payment’, чтобы он считался ожидающим
Пример удаления статуса ‘failed’ из массива ожидающих статусов:
add_filter('woocommerce_order_is_pending_statuses', function($pending_statuses) {
$key = array_search('failed', $pending_statuses);
if ($key !== false) {
unset($pending_statuses[$key]);
}
return $pending_statuses;
});
Здесь мы удаляем статус ‘failed’, чтобы он больше не считался ожидающим
Пример изменения статуса ‘on-hold’ на ‘awaiting-confirmation’:
add_filter('woocommerce_order_is_pending_statuses', function($pending_statuses) {
$key = array_search('on-hold', $pending_statuses);
if ($key !== false) {
$pending_statuses[$key] = 'awaiting-confirmation';
}
return $pending_statuses;
});
В этом примере мы меняем статус ‘on-hold’ на ‘awaiting-confirmation’
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить список статусов заказов, которые считаются ожидающими, для вашей специфики бизнеса
– Производительность
Хук не должен влиять на производительность, так как изменения касаются только логики статусов
– Предупреждения
Убедитесь, что добавляемые или изменяемые статусы правильно обрабатываются в других частях WooCommerce
Альтернативы
Тип: action
Этот хук позволяет выполнять действия при изменении статуса заказа, что может быть полезно в некоторых случаях
Используйте его, если необходимо выполнять дополнительные действия при изменении статуса заказа, а не просто изменять массив статусов
