WooCommerce: программное изменение адреса платежа и доставки в заказах

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

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

Если попытаться изменить адреса напрямую через административную панель, это неудобно и не подходит для массовых или автоматизированных сценариев. Поэтому нужно использовать hooks и методы WooCommerce для надежного обновления данных.

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

Использование WC_Order для обновления адресов

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

Пример кода для изменения адреса платежа и доставки:

function update_order_addresses( $order_id, $billing_address, $shipping_address ) {
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return false; // Заказ не найден
    }

    // Обновляем адрес платежа
    $order->set_billing_first_name( $billing_address['first_name'] );
    $order->set_billing_last_name( $billing_address['last_name'] );
    $order->set_billing_address_1( $billing_address['address_1'] );
    $order->set_billing_address_2( $billing_address['address_2'] );
    $order->set_billing_city( $billing_address['city'] );
    $order->set_billing_postcode( $billing_address['postcode'] );
    $order->set_billing_country( $billing_address['country'] );
    $order->set_billing_state( $billing_address['state'] );
    $order->set_billing_email( $billing_address['email'] );
    $order->set_billing_phone( $billing_address['phone'] );

    // Обновляем адрес доставки
    $order->set_shipping_first_name( $shipping_address['first_name'] );
    $order->set_shipping_last_name( $shipping_address['last_name'] );
    $order->set_shipping_address_1( $shipping_address['address_1'] );
    $order->set_shipping_address_2( $shipping_address['address_2'] );
    $order->set_shipping_city( $shipping_address['city'] );
    $order->set_shipping_postcode( $shipping_address['postcode'] );
    $order->set_shipping_country( $shipping_address['country'] );
    $order->set_shipping_state( $shipping_address['state'] );

    $order->save();

    return true;
}

Подставьте реальные данные в массивы $billing_address и $shipping_address. Пример вызова:

$billing = [
    'first_name' => 'Иван',
    'last_name'  => 'Иванов',
    'address_1'  => 'ул. Ленина, д.10',
    'address_2'  => '',
    'city'       => 'Москва',
    'postcode'   => '101000',
    'country'    => 'RU',
    'state'      => 'MOW',
    'email'      => 'ivanov@example.com',
    'phone'      => '+79991234567'
];

$shipping = [
    'first_name' => 'Иван',
    'last_name'  => 'Иванов',
    'address_1'  => 'ул. Пушкина, д.5',
    'address_2'  => 'кв.12',
    'city'       => 'Москва',
    'postcode'   => '101001',
    'country'    => 'RU',
    'state'      => 'MOW'
];

update_order_addresses( 1234, $billing, $shipping );

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

Если требуется менять адреса только при определенных условиях, например при смене статуса заказа, используйте хук woocommerce_order_status_changed:

add_action( 'woocommerce_order_status_changed', 'update_addresses_on_status_change', 10, 4 );
function update_addresses_on_status_change( $order_id, $old_status, $new_status, $order ) {
    if ( 'processing' === $new_status ) {
        $billing = [
            'first_name' => 'Петр',
            'last_name'  => 'Петров',
            'address_1'  => 'ул. Новая, д.1',
            'address_2'  => '',
            'city'       => 'Санкт-Петербург',
            'postcode'   => '190000',
            'country'    => 'RU',
            'state'      => 'SPE'
        ];
        $shipping = $billing; // Пример одинаковых адресов
        update_order_addresses( $order_id, $billing, $shipping );
    }
}

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

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

• Откройте заказ в админке WooCommerce, проверьте разделы «Адрес платежа» и «Адрес доставки» — новые данные должны отображаться.
• Выведите адреса на фронтенде через шаблон заказа или с помощью кода:

$order = wc_get_order( 1234 );
echo 'Billing address: ' . $order->get_formatted_billing_address();
echo 'Shipping address: ' . $order->get_formatted_shipping_address();

Если изменения не отображаются, проверьте, вызывался ли метод $order->save() и нет ли ошибок в логах PHP.

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

• Ошибка: Изменения не сохраняются.
  Причина: не вызван метод save() объекта заказа.
  Исправление: всегда вызывайте $order->save(); после установки новых данных.
• Ошибка: Некорректный формат данных адреса.
  Причина: передача неполных или неверных данных.
  Исправление: проверяйте, что все обязательные поля заполнены и соответствуют формату WooCommerce.
• Ошибка: Конфликты с другими плагинами или темой.
  Причина: хуки могут переопределяться, или происходит кеширование.
  Исправление: тестируйте на чистом сайте, отключайте плагины по очереди, очищайте кеш.

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

• Обрабатывайте изменения адресов только для авторизованных пользователей или с проверкой прав доступа, чтобы избежать несанкционированных изменений.
• Если обновление происходит массово, выполняйте операции пакетно и с минимальным количеством вызовов save(), чтобы снизить нагрузку на базу данных.
• Для интеграций с внешними сервисами используйте очередь задач или WP Cron, чтобы изменения не тормозили работу сайта.
• Логируйте изменения адресов с указанием пользователя и времени, чтобы быстро выявлять возможные ошибки или злоупотребления.

Сравнение способов изменения адресов в WooCommerce