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

Диагностика задачи: зачем менять статус заказа по региону

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

Настройка автоматического изменения статуса заказа по региону

Определение региона покупателя

Для начала нужно получить регион покупателя из данных заказа. В WooCommerce регион задаётся через штат/область (shipping_state) или страну (shipping_country).

function get_order_region( $order ) {
    $region = $order->get_shipping_state(); // Например, 'CA' для Калифорнии
    if ( ! $region ) {
        $region = $order->get_shipping_country(); // fallback, если штат не указан
    }
    return $region;
}

Автоматическое изменение статуса заказа

Добавим хук, который срабатывает при создании заказа (woocommerce_thankyou) или при смене статуса (woocommerce_order_status_processing). В примере меняем статус на on-hold для заказов из региона 'CA' (Калифорния).

add_action( 'woocommerce_thankyou', 'change_order_status_by_region', 20, 1 );
function change_order_status_by_region( $order_id ) {
    if ( ! $order_id ) {
        return;
    }
    $order = wc_get_order( $order_id );
    $region = get_order_region( $order );

    // Задайте регионы, для которых нужен особый статус
    $special_regions = array( 'CA', 'NY' );

    if ( in_array( $region, $special_regions ) ) {
        // Проверяем, что статус не установлен уже
        if ( 'on-hold' !== $order->get_status() ) {
            $order->update_status( 'on-hold', 'Автоматический перевод по региональному признаку' );
        }
    }
}

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

• Создайте тестовый заказ с адресом доставки в регионе из списка (например, штат CA).
• После оформления заказа перейдите в админку WooCommerce в раздел «Заказы».
• Проверьте, что статус заказа изменился на On hold автоматически.
• Если заказ из другого региона, статус должен остаться без изменений.

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

• Статус не меняется: убедитесь, что хук woocommerce_thankyou корректно срабатывает — можно добавить error_log внутри функции для отладки.
• Регион не определяется: проверьте, что в заказе заполнены поля shipping_state и shipping_country. Если покупатель не указал регион, логика не сработает.
• Конфликты с другими плагинами: если другие плагины или кастомный код также меняют статус заказа, может возникать конфликт. В таком случае можно попробовать приоритет хука увеличить (например, 50).
• Переключение статуса вызывает бесконечный цикл: избегайте вызова update_status внутри хуков, которые сами срабатывают при смене статуса без проверки текущего статуса.

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

• Используйте минимально необходимый список регионов для изменения статуса, чтобы не нагружать систему лишними проверками.
• Добавляйте комментарии к изменению статуса, чтобы сотрудники понимали причину автоматической смены.
• Для масштабируемых решений используйте специализированные плагины для локализации и автоматизации заказов, если функционала кода недостаточно.
• Проверяйте совместимость своего кода с обновлениями WooCommerce и WordPress, чтобы избежать ошибок.

Сравнение вариантов реализации