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

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

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

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

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

• woocommerce_payment_complete — после успешной оплаты;
• woocommerce_order_status_changed — при смене статуса;
• woocommerce_auto_complete_order — автоматическое завершение заказа.

Чтобы диагностировать, какой из них вызывает автоматическое обновление:

1. Включите режим отладки WooCommerce (WP_DEBUG в wp-config.php).
2. Добавьте в файл functions.php темы или в кастомный плагин следующий код для логирования статусов:

add_action('woocommerce_order_status_changed', function($order_id, $old_status, $new_status) {
    error_log("Order #$order_id status changed from $old_status to $new_status");
}, 10, 3);

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

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

Самый простой и надежный способ — отключить автоматическое завершение заказов, а также отменить действия, которые меняют статус после оплаты.

Шаг 1. Отключение автоматического завершения заказа

remove_action('woocommerce_order_status_processing', 'woocommerce_auto_complete_order');

Добавьте этот код в functions.php вашей темы или в кастомный плагин. Это отключит автоматическое завершение заказов при смене статуса на 'processing'.

Шаг 2. Отключение автоматической смены статуса после оплаты

Если ваш платежный шлюз использует хук woocommerce_payment_complete, то вы можете убрать автоматическую смену статуса так:

remove_action('woocommerce_payment_complete', 'wc_payment_complete_order');

Если такой функции нет, то нужно проверить документацию платежного шлюза и отключить автоматическую смену статуса в его настройках или через фильтры.

Шаг 3. Ручное управление статусами

После отключения автоматических хуков статусы нужно менять вручную или через кастомный код.

function custom_manual_order_status_update($order_id, $new_status) {
    if (!in_array($new_status, array('completed', 'cancelled', 'on-hold'))) {
        return;
    }
    $order = wc_get_order($order_id);
    if ($order) {
        $order->update_status($new_status, 'Статус обновлен вручную');
    }
}

Проверка результата

1. Сделайте тестовый заказ с оплатой через выбранный шлюз.
2. Войдите в админку WooCommerce — раздел «Заказы».
3. Проверьте, что статус заказа не меняется автоматически после оплаты.
4. Используйте логи (error_log), чтобы убедиться, что хуки для смены статуса не вызываются.

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

• Код не работает, статус все равно меняется: возможно, платежный шлюз использует свои собственные хуки. Проверьте документацию и отключите автоматические обновления в настройках шлюза.
• Ошибка в файле functions.php: проверьте синтаксис кода, отсутствие лишних пробелов и правильное подключение файла.
• Удаление хуков происходит слишком рано или поздно: убедитесь, что remove_action вызывается после того, как хуки были добавлены. Обычно это делают на хук plugins_loaded или init с приоритетом 20.
• Статусы обновляются другими плагинами: временно отключите сторонние плагины, чтобы выявить конфликт.

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

• Не изменяйте исходные файлы WooCommerce — все изменения делайте через дочернюю тему или кастомный плагин.
• Для оптимизации логики управления заказами используйте WP Cron для отложенных задач, если нужна автоматизация с задержкой.
• Ограничьте доступ к странице управления заказами только доверенным пользователям для безопасности.
• Включите логирование событий смены статусов для аудита и быстрого выявления проблем.

Сравнение подходов отключения автоматического обновления статусов