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

Диагностика проблемы: когда нужно автоматизировать смену статуса заказа

В стандартной установке WooCommerce статус заказа меняется вручную либо по событиям, связанным с оплатой и доставкой. Однако бывают кейсы, когда нужно программно менять статус заказа, например, после проверки оплаты сторонними сервисами, обработки возвратов или при кастомных условиях. Без автоматизации это приводит к ошибкам, задержкам и нагрузке на поддержку.

Выбор подходящего хука WooCommerce для смены статуса

WooCommerce предоставляет несколько хуков, которые позволяют отслеживать изменения в заказах и программно менять их статусы:

• woocommerce_order_status_changed — срабатывает при изменении статуса заказа.
• woocommerce_thankyou — вызывается после успешной оплаты, можно запускать дополнительные проверки.
• woocommerce_order_status_{status} — специфичный хук для конкретного статуса (например, woocommerce_order_status_processing).

Для автоматического изменения статуса удобно создать свою функцию и привязать её к одному из этих хуков или к кастомному событию.

Пошаговое решение: автоматическое обновление статуса заказа

Рассмотрим пример: после проверки стороннего API платежа меняем статус заказа на «завершён» (completed), если оплата подтверждена.

add_action('woocommerce_thankyou', 'auto_update_order_status_after_payment', 10, 1);
function auto_update_order_status_after_payment($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);

    // Пример проверки оплаты через сторонний API
    $payment_confirmed = check_external_payment_api($order_id); // Функция должна вернуть true/false

    if ($payment_confirmed && $order->get_status() !== 'completed') {
        $order->update_status('completed', 'Автоматическое обновление статуса после подтверждения оплаты.');
    }
}

function check_external_payment_api($order_id) {
    // Здесь реализация запроса к API платёжного сервиса
    // Для примера возвращаем true
    return true;
}

Эта функция вызывается после успешного оформления заказа и проверяет, действительно ли оплата прошла. После подтверждения статус меняется без участия администратора.

Проверка результата после внедрения

1. Создайте тестовый заказ в WooCommerce через фронтенд.
2. Убедитесь, что функция проверки оплаты (например, check_external_payment_api) возвращает true.
3. После оформления заказа проверьте в админке, что статус изменился на «завершён» автоматически.
4. Проверьте логи WooCommerce (WooCommerce → Статус → Логи), чтобы убедиться, что комментарий об обновлении статуса появился.

Частые ошибки и как их исправить

• Функция не вызывается или статус не меняется: проверьте, что $order_id корректно передаётся, и что хук подключён правильно. Для отладки используйте error_log или WP_DEBUG.
• Несоответствие статусов: убедитесь, что используете правильные имена статусов WooCommerce (например, completed, processing, on-hold).
• Конфликт с другими плагинами: временно отключите другие плагины, чтобы исключить вмешательство в логику смены статуса.
• Отсутствие проверки безопасности: добавьте nonce и проверку прав пользователя, если меняете статус не только в хуках, а через AJAX или формы.

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

• Не запускайте тяжёлые операции напрямую в хуках. Если требуется длительная обработка, используйте WP-Cron или асинхронные задачи WP Background Processing.
• Всегда проверяйте права доступа и валидность данных перед изменением статусов.
• Логируйте изменения статусов с комментариями для аудита и отладки.
• Используйте фильтры WooCommerce для кастомизации работы с заказами, если нужно изменить логику более гибко.

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