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

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

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

Для диагностики проблемы нужно понять, какие именно данные не обновляются и в какой момент. Часто разработчики пытаются использовать хуки woocommerce_order_status_changed или woocommerce_order_status_{old_status}_to_{new_status}, но делают это неправильно, либо забывают вызвать сохранение заказа.

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

1. Выбор правильного хука

Используйте хук woocommerce_order_status_changed, который срабатывает при любом изменении статуса заказа. Он передаёт три параметра: ID заказа, старый статус и новый статус.

add_action('woocommerce_order_status_changed', 'custom_update_order_on_status_change', 10, 3);

2. Обработка данных в функции

В функции можно получить объект заказа, обновить метаданные или пользовательские поля и сохранить изменения.

function custom_update_order_on_status_change($order_id, $old_status, $new_status) {
    if ($new_status === 'completed') { // пример: обновлять только для статуса "завершён"
        $order = wc_get_order($order_id);
        if (!$order) {
            return;
        }

        // Обновим произвольное мета-поле
        $order->update_meta_data('_custom_field', 'значение обновлено автоматически');

        // Пересчитаем общую стоимость, если нужно
        $new_total = calculate_custom_total($order);
        $order->set_total($new_total);

        // Сохраним изменения
        $order->save();
    }
}

function calculate_custom_total($order) {
    $items = $order->get_items();
    $sum = 0;
    foreach ($items as $item) {
        $product = $item->get_product();
        $quantity = $item->get_quantity();
        $price = $product ? $product->get_price() : 0;
        $sum += $price * $quantity;
    }
    // Добавим 10% налог, например
    return $sum * 1.1;
}

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

• Создайте тестовый заказ и смените его статус на "Завершён" в админке WooCommerce.
• Проверьте в базе данных или через админку, что мета-поле _custom_field обновилось.
• Проверьте, что итоговая сумма заказа изменилась согласно логике.

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

После внедрения кода смените статус нескольких тестовых заказов. Убедитесь, что:

• Хук срабатывает - можно добавить error_log или временно вывести сообщение.
• Мета-данные обновились - просмотрите заказ через phpMyAdmin или плагины типа WP All Export/Import.
• Общая стоимость заказа пересчитана и отображается корректно.

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

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

• Не срабатывает хук: проверьте приоритет и количество аргументов в add_action. Для woocommerce_order_status_changed нужно 3 аргумента.
• Данные не сохраняются: обязательно вызывайте $order->save(); после внесения изменений.
• Ошибки при получении заказа: используйте wc_get_order($order_id), а не прямое обращение к базе.
• Изменения не видны в админке: возможно, включено агрессивное кеширование или страницы не обновлены.

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

• Обрабатывайте только необходимые статусы, чтобы не нагружать систему лишними вызовами.
• Избегайте тяжелых вычислений в хукe, если они влияют на UX администратора.
• Проверяйте, что объект заказа валиден перед модификацией.
• Для сложных изменений используйте асинхронные задачи или WP-Cron, чтобы не блокировать интерфейс.

Сравнение подходов: плагин vs кастомный код