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

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

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

Частые симптомы проблемы:

• Адрес доставки не заполняется автоматически, хотя данные доступны.
• Клиенты жалуются, что адрес приходится вводить повторно.
• Проблемы с синхронизацией данных между пользовательскими полями и стандартными полями доставки.

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

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

Пошаговое решение через хук woocommerce_checkout_update_order_review

Этот хук срабатывает при обновлении обзора заказа на этапе оформления, что позволяет вмешаться в данные и подставить адрес доставки.

add_action('woocommerce_checkout_update_order_review', 'auto_set_shipping_address_from_custom_source', 10, 1);
function auto_set_shipping_address_from_custom_source($posted_data) {
    parse_str($posted_data, $output);

    // Пример: получаем адрес из пользовательского мета или API
    $custom_address = get_user_meta(get_current_user_id(), 'custom_shipping_address', true);

    if (!empty($custom_address)) {
        WC()->checkout()->set_value('shipping_first_name', $custom_address['first_name']);
        WC()->checkout()->set_value('shipping_last_name', $custom_address['last_name']);
        WC()->checkout()->set_value('shipping_address_1', $custom_address['address_1']);
        WC()->checkout()->set_value('shipping_address_2', $custom_address['address_2']);
        WC()->checkout()->set_value('shipping_city', $custom_address['city']);
        WC()->checkout()->set_value('shipping_postcode', $custom_address['postcode']);
        WC()->checkout()->set_value('shipping_country', $custom_address['country']);
        WC()->checkout()->set_value('shipping_state', $custom_address['state']);
    }
}

Этот пример берет адрес из метаданных пользователя и подставляет его в поля доставки на странице оформления.

Другой вариант — установка адреса при создании объекта заказа

Если нужно автоматически задавать адрес уже при создании заказа, можно использовать хук woocommerce_checkout_create_order:

add_action('woocommerce_checkout_create_order', 'set_shipping_address_on_order_create', 20, 2);
function set_shipping_address_on_order_create($order, $data) {
    $custom_address = get_user_meta($order->get_user_id(), 'custom_shipping_address', true);
    if (!empty($custom_address)) {
        $order->set_shipping_first_name($custom_address['first_name']);
        $order->set_shipping_last_name($custom_address['last_name']);
        $order->set_shipping_address_1($custom_address['address_1']);
        $order->set_shipping_address_2($custom_address['address_2']);
        $order->set_shipping_city($custom_address['city']);
        $order->set_shipping_postcode($custom_address['postcode']);
        $order->set_shipping_country($custom_address['country']);
        $order->set_shipping_state($custom_address['state']);
    }
}

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

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

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

• Адрес не подставляется: возможно, данные не сохранены в нужном формате или ключи массива адреса отличаются от используемых (проверьте структуру массива).
• Поля доставки остаются пустыми: убедитесь, что вызов WC()->checkout()->set_value() происходит на нужном хуке и с правильным приоритетом.
• Адрес не сохраняется в заказе: для сохранения данных в объекте заказа используйте хук woocommerce_checkout_create_order, не забудьте вызвать методы set_shipping_*.
• Проблемы с кешированием страницы оформления: отключите кеширование для страницы оформления заказа, иначе динамические данные не будут подставляться.

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

• Не доверяйте пользовательскому вводу и всегда очищайте получаемые данные через sanitize_text_field() или подобные функции.
• Для частых запросов к базе данных используйте кеширование результатов, чтобы не нагружать сервер.
• Отключайте кеширование страниц оформления заказа и корзины, чтобы избежать конфликтов с динамическими данными.
• Если используете сторонние API для получения адреса, обрабатывайте ошибки и таймауты, чтобы не ухудшить UX.

Сравнение методов автоматической установки адреса доставки