WooCommerce: автоматическое изменение статуса заказа по условиям

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

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

• Правильно ли настроены хуки и условия в коде.
• Нет ли конфликтов с плагинами, которые могут блокировать изменения.
• Работает ли cron на сервере, если обновление зависит от запланированных задач.
• Есть ли ошибки PHP в логах, связанные с обработкой заказа.

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

Рассмотрим пример: автоматически изменить статус заказа на completed, если заказ оплачен и в нём есть товар из определённой категории.

Шаг 1. Добавляем хук на изменение статуса заказа

add_action('woocommerce_order_status_processing', 'custom_auto_complete_order', 10, 1);

function custom_auto_complete_order($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) {
        return;
    }

    // Проверяем, есть ли товар из нужной категории
    $target_category = 'digital'; // slug категории
    $has_target_category = false;

    foreach ($order->get_items() as $item) {
        $product_id = $item->get_product_id();
        if (has_term($target_category, 'product_cat', $product_id)) {
            $has_target_category = true;
            break;
        }
    }

    if ($has_target_category) {
        $order->update_status('completed', 'Автоматическое завершение для товаров из категории "digital"');
    }
}

В этом коде мы отслеживаем переход заказа в статус processing (обычно после оплаты), и если в заказе есть товары из категории digital, меняем статус на completed.

Шаг 2. Проверяем, что cron работает (если требуется)

Если автоматизация зависит от cron-задач, убедитесь, что WP-Cron не отключен и нормально работает. Для диагностики можно использовать плагин WP Crontrol. Если cron отключен, настройте системный планировщик задач (crontab) на сервере для вызова wp-cron.php.

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

• Создайте тестовый заказ с товаром из категории digital.
• Оплатите заказ (можно использовать режим тестовых платежей).
• Перейдите в админку WooCommerce, проверьте, что статус изменился с processing на completed.
• Проверьте, что в комментариях к заказу появилась запись из функции update_status.

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

• Статус не меняется: проверьте правильность slug категории, использование правильных хуков (например, woocommerce_order_status_processing), а также наличие ошибок PHP.
• Конфликт с другими плагинами: временно отключите сторонние плагины, особенно те, которые работают с заказами и статусами.
• Неправильный статус для обновления: не пытайтесь менять статус внутри хука, который уже срабатывает при изменении этого же статуса без проверки условий — это может привести к зацикливанию.
• Отсутствие уведомлений: если нужно отправлять письма при смене статуса, убедитесь, что вызывается соответствующий метод, например, $order->save() после изменения статуса.

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

• Не используйте слишком тяжёлые операции внутри хуков изменения статуса — например, запросы к внешним API, которые могут замедлить обработку.
• Избегайте повторных обновлений статуса для одного заказа в короткий промежуток времени, чтобы не создавать лишнюю нагрузку и не путать пользователей.
• Используйте проверку nonce и права доступа, если автоматическое обновление связано с пользовательскими действиями.
• Логируйте критичные изменения статусов для последующего аудита и отладки.

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