WooCommerce: как автоматически обновлять адрес доставки после оформления заказа

Проблема: необходимость автоматического обновления адреса доставки

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

Диагностика проблемы

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

• Создайте тестовый заказ с одним адресом доставки.
• Попробуйте изменить адрес пользователя в профиле после оформления заказа.
• Откройте заказ в админке WooCommerce и проверьте, остался ли старый адрес доставки.

Если адрес не меняется, значит требуется кастомный код для обновления после создания заказа.

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

Для изменения адреса доставки после оформления заказа используем хук woocommerce_checkout_update_order_meta, который срабатывает сразу после создания заказа, но до сохранения метаданных.

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

add_action('woocommerce_checkout_update_order_meta', 'custom_update_shipping_address_after_order', 10, 2);
function custom_update_shipping_address_after_order($order_id, $data) {
    $order = wc_get_order($order_id);

    // Новый адрес доставки
    $new_shipping_address = array(
        'first_name' => 'Иван',
        'last_name'  => 'Иванов',
        'address_1'  => 'ул. Новая, д. 10',
        'address_2'  => 'кв. 5',
        'city'       => 'Москва',
        'state'      => 'MOW',
        'postcode'   => '123456',
        'country'    => 'RU',
    );

    // Устанавливаем новые данные адреса доставки
    foreach ($new_shipping_address as $key => $value) {
        $order->set_shipping_address_{$key}($value);
    }

    $order->save();
}

В данном примере адрес доставки жестко задаётся. В реальной задаче данные могут поступать из пользовательских полей, API или других источников.

Объяснение кода

• Используем хук woocommerce_checkout_update_order_meta с двумя параметрами: ID заказа и данные формы.
• Получаем объект заказа WC_Order.
• В цикле вызываем сеттеры адреса доставки set_shipping_address_*.
• Сохраняем изменения вызовом $order->save();.

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

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

1. Оформите новый заказ на тестовом сайте.
2. Перейдите в админку WooCommerce, откройте созданный заказ.
3. В блоке с адресом доставки убедитесь, что отображается новый адрес, заданный в коде.
4. Также можно вывести адрес доставки в письме с подтверждением заказа или на странице пользователя.

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

• Адрес не меняется после оформления заказа: Проверьте, что код подключён в functions.php текущей темы или в отдельном плагине и что хук используется правильно.
• Ошибка вызова метода set_shipping_address_*: Убедитесь, что используете версию WooCommerce 3.0+ (объектно-ориентированная модель).
• Адрес частично обновляется или сохраняется некорректно: Проверьте, что все необходимые поля корректно указаны, особенно country и state, иначе WooCommerce не сохранит адрес.
• Конфликт с другими плагинами: Отключите сторонние расширения, которые изменяют адреса, чтобы исключить конфликт.

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

• Не используйте жёстко заданные адреса в продакшене, лучше получать их из валидационных источников.
• Если данные приходят из формы, валидируйте и фильтруйте их с помощью функций sanitize_text_field и wc_clean.
• Не вызывайте $order->save() несколько раз подряд без необходимости — это снижает производительность.
• Для массового обновления адресов лучше использовать WP CLI скрипты вместо хуков.

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