Как использовать хуки WooCommerce для автоматизации управления заказами

Диагностика задачи: зачем автоматизировать управление заказами в WooCommerce?

Автоматизация обработки заказов позволяет сократить ручной труд, снизить ошибки и повысить скорость реакции на действия покупателей. Частые сценарии: автоматическое изменение статуса заказа, отправка уведомлений, интеграция с CRM или складом, применение скидок или бонусов при выполнении условий.

В WooCommerce для таких задач используются хуки — actions и filters, которые позволяют встраивать собственный код в процесс обработки заказа.

Какие хуки WooCommerce использовать для автоматизации заказов

Хуки изменения статуса заказов

Самые востребованные хуки:

• woocommerce_order_status_changed — вызывается при любом изменении статуса заказа.
• woocommerce_order_status_{new_status} — вызывается при переходе заказа в конкретный статус, например woocommerce_order_status_completed.

Пример: автоматическое добавление пользовательской метки при переходе заказа в статус «завершён».

add_action('woocommerce_order_status_completed', 'add_custom_order_note_on_completed');
function add_custom_order_note_on_completed($order_id) {
    $order = wc_get_order($order_id);
    $order->add_order_note('Заказ автоматически отмечен как завершён.');
}

Хуки перед сохранением или обновлением заказа

Для проверки и изменения данных перед сохранением:

• woocommerce_checkout_create_order — перед созданием заказа на этапе оформления.
• woocommerce_update_order — при обновлении заказа.

Пошаговое решение: автоматическое уведомление менеджера при новом заказе с высокой суммой

1. Подключиться к хуку woocommerce_thankyou — вызывается после оформления заказа.
2. Проверить сумму заказа.
3. Отправить email менеджеру, если сумма больше пороговой.

add_action('woocommerce_thankyou', 'notify_manager_if_high_order');
function notify_manager_if_high_order($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    $total = $order->get_total();
    $threshold = 10000; // Пороговая сумма
    if ($total > $threshold) {
        $to = 'manager@example.com';
        $subject = 'Новый крупный заказ';
        $message = 'Заказ №' . $order_id . ' на сумму ' . $total . ' руб.';
        wp_mail($to, $subject, $message);
    }
}

Как проверить, что автоматизация работает

• Оформите тестовый заказ с суммой выше и ниже порога.
• Убедитесь, что менеджер получает email только при превышении порога.
• Проверьте логи сервера и wp_mail (для отладки можно подключить плагин Email Log).
• Для хуков изменения статуса проверьте добавление заметок в заказ на странице редактирования заказа в админке.

Частые ошибки при использовании хуков WooCommerce для заказов

• Неверный хук или отсутствие проверки ID заказа. Всегда проверяйте, что $order_id валиден, иначе код может упасть.
• Отправка email без проверки результата. Используйте логирование для отладки.
• Перезаписывание данных заказа без сохранения. Если вы изменяете объект заказа, обязательно вызывайте $order->save();.
• Неучёт асинхронных операций и кеша. При сложной логике лучше использовать очередь WP-Cron для выполнения задач.

Практические советы по безопасности и производительности

• Не выполняйте тяжелые операции (запросы к внешним API, сложные SQL) напрямую в хуках — используйте WP-Cron или очереди.
• Проверяйте права пользователя и валидируйте данные, если изменения заказа инициируются через REST API или формы.
• Для отправки почты используйте SMTP через плагины, чтобы избежать проблем с доставкой.
• Минимизируйте количество хуков, чтобы не перегружать обработку заказов.

Сравнение способов автоматизации управления заказами в WooCommerce