WooCommerce: Автоматическое изменение статуса заказов с помощью хуков

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

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

Как автоматически изменить статус заказа в WooCommerce: пошаговое решение

1. Использование хука woocommerce_order_status_completed для запуска действия после смены статуса

Рассмотрим простой пример — после перевода заказа в статус «Выполнен» автоматически отправить уведомление или изменить другой параметр.

add_action('woocommerce_order_status_completed', 'my_custom_action_after_order_completed', 10, 1); 
function my_custom_action_after_order_completed($order_id) {
    $order = wc_get_order($order_id);
    // Ваш код, например, отправка кастомного уведомления
    error_log('Заказ #'.$order_id.' выполнен и обработан автоматически.');
}

2. Автоматическое изменение статуса заказа через CRON или WP-Cron

Если нужно менять статус заказа спустя определённое время с момента создания, можно использовать WP-Cron.

// Планируем событие при создании заказа
add_action('woocommerce_thankyou', 'schedule_order_status_change');
function schedule_order_status_change($order_id) {
    if (!wp_next_scheduled('auto_change_order_status_event', array($order_id))) {
        // Запускаем через 1 час (3600 секунд)
        wp_schedule_single_event(time() + 3600, 'auto_change_order_status_event', array($order_id));
    }
}

// Обработчик события
add_action('auto_change_order_status_event', 'auto_change_order_status_callback');
function auto_change_order_status_callback($order_id) {
    $order = wc_get_order($order_id);
    if ($order && 'processing' === $order->get_status()) {
        $order->update_status('completed', 'Статус автоматически обновлён через час после оформления.');
    }
}

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

• Создайте тестовый заказ с нужным статусом (например, processing).
• Проверьте логи сервера на наличие записи из error_log при смене статуса.
• Для WP-Cron убедитесь, что событие запланировано, выполнилось и статус заказа обновился через указанный промежуток времени.
• Проверяйте историю изменений заказа в панели WooCommerce — там должна появиться запись с вашим комментарием.

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

• Не срабатывает WP-Cron: По умолчанию WP-Cron запускается при посещении сайта. Если нет посетителей, задачи не выполняются. Решение: настроить системный CRON или использовать плагин для управления WP-Cron.
• Хук срабатывает несколько раз: Используйте проверку wp_next_scheduled, чтобы не создавать дубликаты задач.
• Неправильный статус заказа: Всегда проверяйте текущий статус заказа перед обновлением, чтобы избежать бесконечных циклов изменения.
• Отсутствие прав на изменение: Убедитесь, что код выполняется с достаточными правами, особенно если используется в административных сценариях.

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

• Используйте проверку nonce, если автоматизация связана с действиями, инициируемыми через пользовательский интерфейс.
• Для массовых изменений статусов избегайте запуска большого числа задач WP-Cron одновременно — группируйте их или используйте системный CRON.
• Логируйте только критичные ошибки, чтобы не перегружать журнал.
• Для уведомлений используйте асинхронные методы или очереди, чтобы не блокировать выполнение основного кода.

Сравнение способов автоматического изменения статуса заказа