WooCommerce: отладка проблем с распоряжением заказами и их статусами

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

Если вы столкнулись с тем, что статусы заказов не меняются автоматически или вручную через админку, сначала проверьте:
1. Конфликты плагинов, особенно с пользовательскими обработчиками статусов.
2. Правильность хука woocommerce_order_status_changed или woocommerce_order_status_{old}_to_{new}, если вы используете кастомные скрипты.
3. Логи ошибок PHP и WooCommerce (включите отладку в wp-config.php через define('WP_DEBUG', true); define('WP_DEBUG_LOG', true);).
4. Наличие ограничений по ролям и правам пользователя, который пытается менять статус.

Проверка через стандартный интерфейс

Перейдите в WooCommerce → Заказы, откройте заказ и попробуйте вручную изменить статус. Если изменение не сохраняется, скорее всего проблема с правами или конфликтом плагинов.

Проверка через код

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

Добавьте этот код в functions.php вашей темы и проверьте файл wp-content/debug.log — появится ли запись при смене статуса.

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

1. Отключите все сторонние плагины, кроме WooCommerce

Проверьте, решит ли это проблему. Если да — включайте плагины по одному, чтобы выявить конфликтующий.

2. Проверьте права пользователя

Стандартные роли WooCommerce используют capability edit_shop_orders для управления заказами. Введите в консоли WP-CLI:

wp user capability list 1 | grep edit_shop_orders

Замените 1 на ID вашего пользователя. Если edit_shop_orders отсутствует — добавьте:

wp user capability add 1 edit_shop_orders

3. Временно переключитесь на стандартную тему (например, Storefront)

Исключите влияние темы.

4. Проверьте пользовательские хук-обработчики

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

5. Исправьте код для изменения статуса

Для программного изменения статуса используйте проверенный метод:

$order = wc_get_order($order_id);
$order->update_status('completed', 'Статус изменен автоматически.');

Не используйте прямое обновление поля post_status в базе.

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

После каждого шага повторно попытайтесь изменить статус заказа вручную и программно. Проверьте лог debug.log на наличие записей о смене статуса. Убедитесь, что в интерфейсе админки статус сохраняется и отображается корректно.

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

• Ошибка: Статус не меняется из-за отсутствия capability.
  Решение: Добавьте возможность edit_shop_orders пользователю.
• Ошибка: Конфликт плагинов, который перехватывает хуки.
  Решение: Поочередное отключение плагинов и выявление виновника.
• Ошибка: Неправильное использование методов изменения статуса (например, прямое обновление БД).
  Решение: Используйте методы класса WC_Order (update_status()).
• Ошибка: Кэширование админки мешает обновлению.
  Решение: Очистите кеш и отключите кеширующие плагины во время отладки.

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

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

Сравнение способов изменения статусов заказов