WooCommerce: как отключить автоматическое обновление статуса заказов

Почему происходит автоматическое обновление статусов заказов в WooCommerce?

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

Автоматизация работает через хуки и встроенные функции, которые реагируют на события в системе оплаты и доставки.

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

Проверьте, не вызывает ли автообновление ошибок, конфликтов с плагинами или системами учёта. Например, если заказ меняет статус преждевременно, или вы не успеваете выполнить внутренние проверки, стоит отключить эту функцию.

Для диагностики включите отладку WooCommerce и просмотрите лог обновлений статусов в WooCommerce → Статус → Журналы. Также проверьте, не вызывают ли хуки, связанные с платежным шлюзом, смену статуса.

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

1. Отключение автообновления для конкретного платежного шлюза

Например, для платежного метода "cheque" WooCommerce автоматически ставит статус "завершен" после оплаты. Чтобы отключить это, добавьте в functions.php вашей темы или в кастомный плагин следующий код:

add_filter('woocommerce_payment_complete_order_status', 'disable_auto_complete_for_cheque', 10, 2);
function disable_auto_complete_for_cheque($status, $order_id) {
    $order = wc_get_order($order_id);
    if ($order && $order->get_payment_method() === 'cheque') {
        return 'processing'; // Оставляем заказ в статусе "в обработке"
    }
    return $status;
}

2. Отключение автообновления через хуки смены статуса

WooCommerce использует функцию woocommerce_auto_complete_order для автоматического перевода заказов в статус "завершен". Чтобы полностью отключить это, используйте следующий код:

remove_action('woocommerce_order_status_processing', 'woocommerce_auto_complete_order');
remove_action('woocommerce_order_status_completed', 'woocommerce_auto_complete_order');

Добавьте этот код в functions.php или в ваш плагин.

3. Отключение автообновления через платежные шлюзы

Некоторые платежные методы вызывают смену статуса через собственные хуки. Для диагностики и отключения в логах WooCommerce найдите соответствующие хуки и отключите их с помощью remove_action().

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

Для проверки:

• Создайте тестовый заказ с выбранным платежным методом.
• Оплатите заказ или переведите его в статус, запускающий автообновление.
• Убедитесь, что статус заказа не меняется автоматически на "завершен" или другой нежелательный.
• Проверьте логи WooCommerce на предмет ошибок.

Если статус не меняется, значит отключение прошло успешно.

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

• Код не работает из-за кеширования: Очистите кеш сайта и браузера.
• Код добавлен в неподходящее место: Убедитесь, что код в functions.php активной темы или в загружаемом плагине.
• Платежный шлюз переписывает статус после отключения: Проверьте документацию платежного шлюза и отключите его хуки аналогично.
• Использование устаревших хуков: Проверьте актуальность хуков в последней версии WooCommerce.

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

• Добавляйте код в дочернюю тему или отдельный плагин, чтобы избежать потери при обновлении.
• Проверяйте совместимость с WooCommerce после каждого обновления.
• Не отключайте автообновление без веской причины — продумайте логику обработки заказов.
• Используйте is_admin() и другие проверки, чтобы код выполнялся только там, где нужно.

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