WooCommerce: как использовать хуки для автоматизации изменений статуса заказа

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

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

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

1. Определите событие для триггера изменения статуса

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

2. Создайте функцию для смены статуса заказа

В функции нужно получить объект заказа и вызвать метод update_status() с нужным статусом:

function wpfaq_change_order_status( $order_id ) {
    if ( ! $order_id ) {
        return;
    }
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return;
    }
    // Проверяем условия, например, статус или мета заказа
    if ( $order->has_status( 'processing' ) ) {
        $order->update_status( 'completed', 'Статус автоматически изменён после оплаты.' );
    }
}

3. Подключите функцию к хуку

На примере изменения статуса после оплаты используйте следующий код:

add_action( 'woocommerce_payment_complete', 'wpfaq_change_order_status' );

4. Использование кастомных условий

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

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

1. Создайте тестовый заказ с нужным статусом, например, processing.

2. Проведите оплату через тестовый шлюз или вручную вызовите хук, если это кастомное событие.

3. Проверьте в админке WooCommerce, что статус заказа изменился на completed (или другой, который вы указали).

4. Для отладки добавьте логирование с помощью error_log() внутри функции, чтобы убедиться, что она выполняется.

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

• Функция не вызывается: проверьте, что хук подключён правильно и файл с кодом загружается (лучше использовать плагин для кастомных сниппетов или functions.php дочерней темы).
• Нет доступа к объекту заказа: убедитесь, что передаёте корректный order_id, и вызываете wc_get_order() успешно.
• Статус не меняется: проверьте, что статус, на который меняете, допустим для заказа (например, нельзя поменять на несуществующий статус).
• Автоматизация срабатывает слишком рано или поздно: выберите корректный хук для вашей задачи и учитывайте, что некоторые события могут срабатывать несколько раз.

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

• Добавляйте проверку прав доступа и валидацию данных, особенно если меняете статус из AJAX или REST API.
• Не используйте тяжелые операции внутри хуков, чтобы не замедлять оформление заказов.
• Используйте асинхронные задачи (WP-Cron или сторонние сервисы), если нужно выполнять сложные проверки перед сменой статуса.

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

Пример полного кода для автоматической смены статуса после оплаты

function wpfaq_auto_complete_order( $order_id ) {
    if ( ! $order_id ) {
        return;
    }
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return;
    }
    // Смена статуса с processing на completed
    if ( $order->has_status( 'processing' ) ) {
        $order->update_status( 'completed', 'Статус изменён автоматически после оплаты.' );
        error_log( "Order #$order_id status changed to completed" );
    }
}
add_action( 'woocommerce_payment_complete', 'wpfaq_auto_complete_order' );