Автообновление статуса заказа в WooCommerce: практическое руководство

Почему нужно автообновлять статус заказа в WooCommerce?

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

Диагностика: когда автообновление статуса не работает

Если вы настроили автообновление, но статус заказа не меняется, проверьте следующее:

• Версия WooCommerce и WordPress совместимы и актуальны.
• Проверены ли настройки платежного шлюза или интеграции, которая должна инициировать смену статуса.
• Работают ли хуки и нет конфликтов с другими плагинами или темой.
• Логи ошибок PHP и WooCommerce не содержат критичных ошибок.

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

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

add_action('woocommerce_payment_complete', 'custom_auto_update_order_status');
function custom_auto_update_order_status($order_id) {
    if (!$order_id) {
        return;
    }
    $order = wc_get_order($order_id);
    if (!$order) {
        return;
    }
    // Проверяем текущий статус заказа
    if ($order->get_status() === 'processing') {
        // Автоматически меняем статус на completed
        $order->update_status('completed', 'Статус обновлен автоматически после оплаты.');
    }
}

Этот код нужно добавить в файл functions.php вашей дочерней темы или в собственный плагин.

Как обновлять статус по другим условиям

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

add_action('my_custom_cron_hook', 'custom_cron_update_order_status');
function custom_cron_update_order_status() {
    $args = array(
        'limit' => 10,
        'status' => 'processing',
    );
    $orders = wc_get_orders($args);
    foreach ($orders as $order) {
        // Проверяем, выполнено ли условие для обновления
        if (my_custom_condition_met($order)) {
            $order->update_status('completed', 'Обновлено по крону.');
        }
    }
}

function my_custom_condition_met($order) {
    // Пример условия: прошло 3 дня с даты заказа
    $date_created = $order->get_date_created();
    return (time() - $date_created->getTimestamp()) > 3 * DAY_IN_SECONDS;
}

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

Чтобы убедиться, что автообновление работает, выполните следующие шаги:

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

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

• Хук не срабатывает: Проверьте, что используемый хук действительно вызывается (например, woocommerce_payment_complete срабатывает только после оплаты). Альтернативно используйте woocommerce_order_status_changed.
• Статус не меняется: Убедитесь, что новый статус допустим для данного заказа и что вы не пытаетесь установить тот же статус, что и текущий.
• Конфликты плагинов: Отключите другие плагины, которые могут перехватывать или отменять обновление статуса.
• Код вызывает фатальную ошибку: Проверьте правильность синтаксиса и вызовов функций, используйте отладку WP_DEBUG.

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

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

Сравнение способов автообновления статуса в WooCommerce