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

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

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

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

Как программно изменить статус заказа в WooCommerce

Основные функции для смены статуса

WooCommerce предоставляет методы объекта WC_Order для управления статусом:

• $order->update_status( $new_status, $note, $manual ) — основной метод для смены статуса с возможностью добавления заметки и контроля отправки уведомлений.
• $order->set_status( $new_status ) — просто изменяет статус, но не запускает дополнительные действия (не рекомендуется для смены статуса).

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

function change_order_status_programmatically( $order_id, $new_status ) {
    if ( ! in_array( $new_status, wc_get_order_statuses() ) ) {
        return new WP_Error( 'invalid_status', 'Неверный статус заказа' );
    }
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return new WP_Error( 'order_not_found', 'Заказ не найден' );
    }
    // Обновляем статус с уведомлением
    $order->update_status( $new_status, 'Статус изменён программно', true );
    return true;
}

Пример вызова функции

$result = change_order_status_programmatically( 1234, 'completed' );
if ( is_wp_error( $result ) ) {
    error_log( 'Ошибка смены статуса: ' . $result->get_error_message() );
} else {
    error_log( 'Статус успешно обновлен' );
}

Пошаговое решение задачи

1. Получите ID заказа для изменения.
2. Проверьте, что новый статус входит в список допустимых статусов WooCommerce. Это можно сделать через wc_get_order_statuses().
3. Получите объект заказа через wc_get_order( $order_id ).
4. Вызовите метод update_status() с нужным статусом, добавьте заметку для истории заказа и укажите, нужно ли отправлять уведомления.
5. Проверьте результат, обработайте ошибки.

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

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

• Проверьте в админке WooCommerce, что статус заказа обновился.
• Убедитесь, что в истории заказа появилась заметка с комментарием об изменении.
• Если включены уведомления, проверьте, что клиент получил письмо (можно тестировать с почтовым логом или плагином для логирования писем).
• Для автоматизации можно добавить логирование в файл через error_log() или кастомный лог.

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

• Использование set_status() вместо update_status() — приводит к тому, что статус меняется, но не запускаются уведомления и не добавляется запись в историю.
  Исправление: всегда используйте update_status().
• Подача неправильного статуса — если указать статус, которого нет в списке, функция ничего не изменит.
  Исправление: проверяйте статус через wc_get_order_statuses().
• Попытка изменить несуществующий заказ — код падает или возвращает ошибку.
  Исправление: всегда проверяйте объект заказа на null.
• Отсутствие прав или контекста — вызов функции вне админки или без нужных прав может привести к ошибкам.
  Исправление: запускайте код в правильном контексте или с нужными правами (например, через хук).

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

• Не меняйте статус заказов напрямую в базе — используйте API WooCommerce.
• Избегайте массового изменения статусов в цикле без пауз — это может привести к нагрузке и блокировкам.
• Если обновление статусов выполняется по крону или ajax, добавьте обработку ошибок и логирование.
• Для сложных сценариев используйте хуки WooCommerce, например woocommerce_order_status_changed для реакции на смену статуса.

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