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

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

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

Чаще всего пользователи пытаются решить задачу через JavaScript или отдельные плагины, что усложняет поддержку и снижает производительность. Правильное решение — использовать хуки WooCommerce на стороне сервера.

Пошаговое решение с примером кода

1. Подключаемся к хуку woocommerce_add_to_cart

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

add_action('woocommerce_add_to_cart', 'custom_change_order_status_after_add_to_cart', 10, 6);
function custom_change_order_status_after_add_to_cart($cart_item_key, $product_id, $quantity, $variation_id, $variation, $cart_item_data) {
    // Получаем объект текущей сессии пользователя
    $user_id = get_current_user_id();

    if (!$user_id) {
        // Для гостей можно реализовать через сессии, но это сложнее
        return;
    }

    // Пытаемся получить последний заказ пользователя с статусом 'pending'
    $args = [
        'customer_id' => $user_id,
        'limit' => 1,
        'orderby' => 'date',
        'order' => 'DESC',
        'status' => 'pending',
    ];
    $orders = wc_get_orders($args);

    if (!empty($orders)) {
        $order = $orders[0];
        // Меняем статус на 'on-hold', например
        $order->update_status('on-hold', 'Статус изменён после добавления товара в корзину');
    }
}

2. Особенности реализации

• Функция работает только для авторизованных пользователей, так как привязка к заказам ведётся по ID пользователя.
• Если нужно работать с гостями — придётся сохранять данные в сессии и создавать заказ вручную.
• Статусы заказа можно менять на любые доступные в WooCommerce (pending, on-hold, processing, completed и т.д.).

Как проверить, что решение сработало

1. Авторизуйтесь на сайте с аккаунтом клиента.
2. Добавьте товар в корзину.
3. Перейдите в админку WooCommerce – Заказы.
4. Найдите последний заказ пользователя с датой изменения после добавления товара.
5. Проверьте, что статус заказа сменился на нужный, например, on-hold.
6. Для отладки можно добавить error_log или использовать плагины типа Query Monitor, чтобы отследить вызов функции.

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

• Заказы не меняют статус: убедитесь, что у пользователя есть заказ с нужным статусом, и что пользователь авторизован.
• Функция не вызывается: проверьте правильность подключения хука и отсутствие конфликтов с другими плагинами.
• Проблемы с гостевыми пользователями: WooCommerce не привязывает заказы к гостям напрямую, для них нужен отдельный механизм сохранения и поиска заказов.
• Изменение статуса вызывает циклы: избегайте изменения статуса внутри хука, который триггерит другие изменения, чтобы не вызвать бесконечную рекурсию.

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

• Не выполняйте запросы к базе данных без необходимости — кешируйте результаты, если функция вызывается часто.
• Проверяйте права пользователя перед изменением заказов, чтобы избежать изменения чужих данных.
• Добавляйте записи в лог только в режиме разработки, чтобы не засорять логи на продакшене.
• Тестируйте на staging-сайте перед внедрением на живом сайте.

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