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

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

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

Основные хуки WooCommerce для работы со статусами заказов

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

• woocommerce_order_status_changed — срабатывает при изменении статуса заказа;
• woocommerce_order_status_{from}_to_{to} — срабатывает при переходе со статуса {from} на {to};
• woocommerce_checkout_order_processed — срабатывает после создания заказа на этапе оформления.

Пример: автоматическое удаление товара из заказов после возврата

Задача: после смены статуса заказа на refunded автоматически удалить определённый товар из заказа.

add_action('woocommerce_order_status_changed', 'remove_product_on_refund', 10, 4);
function remove_product_on_refund($order_id, $old_status, $new_status, $order) {
    if ($new_status === 'refunded') {
        foreach ($order->get_items() as $item_id => $item) {
            // ID товара, который нужно удалить
            $product_id_to_remove = 123;
            if ($item->get_product_id() == $product_id_to_remove) {
                $order->remove_item($item_id);
            }
        }
        $order->calculate_totals();
        $order->save();
    }
}

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

1. Определите бизнес-логику — какой статус и при каких условиях необходимо изменить.
2. Выберите подходящий хук — например, woocommerce_order_status_changed для отслеживания смены статуса.
3. Напишите функцию с логикой изменения. Для изменения статуса используйте метод $order->update_status('new_status').
4. Подключите функцию к хуку с помощью add_action.
5. Протестируйте на тестовом заказе.

Пример: автоматическая смена статуса на "в обработке" после создания заказа с определённым товаром

add_action('woocommerce_checkout_order_processed', 'auto_set_processing_status_for_special_product', 20, 1);
function auto_set_processing_status_for_special_product($order_id) {
    $order = wc_get_order($order_id);
    $special_product_id = 456;
    foreach ($order->get_items() as $item) {
        if ($item->get_product_id() == $special_product_id) {
            // Устанавливаем статус "processing"
            $order->update_status('processing', 'Автоматическая смена статуса для специального товара');
            break;
        }
    }
}

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

• Создайте тестовый заказ с нужными товарами или условиями.
• Проверьте, что статус заказа меняется автоматически согласно логике.
• Посмотрите в админке WooCommerce историю изменений статуса заказа.
• При необходимости включите режим отладки, добавив логирование в функции, например, через error_log() или плагин Debug Bar.

Частые ошибки и способы исправления

• Функция не срабатывает: проверьте, что хук подключён правильно, и что приоритет не конфликтует с другими плагинами.
• Статус не меняется: убедитесь, что используете метод $order->update_status(), а не просто меняете поле в базе.
• Ошибка при удалении товаров из заказа: всегда вызывайте $order->calculate_totals() и $order->save() после изменений.
• Конфликты с другими плагинами: попробуйте отключить сторонние плагины или проверить работу на чистой установке.

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

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

Сравнение методов автоматической смены статуса заказов