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

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

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

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

Как проверить источник изменения статуса?

• Включите журнал событий WooCommerce: WooCommerce > Статус > Логи.
• Отследите статус заказа и время его изменения.
• Временно отключите сторонние плагины, связанные с оплатой и заказами.
• Проверьте кастомные функции в теме и плагинах, которые могут вызывать wp_update_post или wc_update_order_status.

Пошаговое решение: как отключить автоматическую смену статуса заказа

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

1. Перехват и отмена смены статуса с помощью хука woocommerce_order_status_changed

Этот хук вызывается после изменения статуса. Чтобы предотвратить изменение, нужно вмешаться раньше — через фильтр woocommerce_pre_transition_order_status (начиная с WooCommerce 7.0).

2. Использование фильтра woocommerce_pre_transition_order_status

add_filter('woocommerce_pre_transition_order_status', 'disable_auto_status_change', 10, 3);function disable_auto_status_change($new_status, $old_status, $order) {    // Список статусов, которые хотим заблокировать    $blocked_statuses = array('processing', 'completed');    // Если пытаются сменить статус на один из заблокированных — отменяем смену    if (in_array($new_status, $blocked_statuses)) {        return $old_status; // возвращаем старый статус, отменяя изменение    }    return $new_status;}

В этом примере мы блокируем автоматический переход заказов в статусы "Обработка" и "Завершён".

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

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

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

• Ошибка: Фильтр не срабатывает, статус меняется автоматически.
  Причина: WooCommerce ниже версии 7.0, в которой нет фильтра woocommerce_pre_transition_order_status.
  Решение: Обновить WooCommerce или использовать альтернативные хуки (ниже).
• Ошибка: Статус меняется после успешной оплаты, несмотря на фильтр.
  Причина: Платёжный шлюз напрямую обновляет статус через API.
  Решение: Найти и изменить код плагина шлюза или использовать хук woocommerce_order_status_changed для отката статуса.
• Ошибка: При блокировке смены статуса страница оформления заказа подвисает или возникают ошибки.
  Причина: Некорректное возвращение значения фильтра.
  Решение: Всегда возвращать корректный статус заказа, чтобы не нарушать логику WooCommerce.

Альтернативное решение для старых версий WooCommerce

Если фильтр woocommerce_pre_transition_order_status недоступен, можно использовать хук woocommerce_order_status_changed для отката статуса:

add_action('woocommerce_order_status_changed', 'revert_status_change', 10, 4);function revert_status_change($order_id, $old_status, $new_status, $order) {    $blocked_statuses = array('processing', 'completed');    if (in_array($new_status, $blocked_statuses)) {        // Откатываем статус обратно        $order->set_status($old_status, 'Откат автоматической смены статуса');        $order->save();    }}

Этот метод менее предпочтителен, так как статус уже меняется, и откат происходит после факта.

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

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

Сравнение вариантов реализации