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

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

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

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

Частые проблемы при реализации автоматической подгрузки адреса по телефону:

• Отсутствие данных в базе (нет ранее сохраненных заказов с телефоном).
• Телефон в новом заказе форматируется иначе, чем в базе (например, +7 и 8 или пробелы).
• Отсутствие триггера на изменение поля телефона в форме оформления заказа.
• Ошибки в AJAX-запросах (например, неправильный URL admin-ajax.php или отсутствие nonce).
• Кэширование страницы, мешающее обновлению данных.

Пошаговое решение: реализация автозаполнения адреса по телефону

1. Добавляем AJAX-обработчик для поиска адреса по телефону

add_action('wp_ajax_get_address_by_phone', 'get_address_by_phone_callback');
add_action('wp_ajax_nopriv_get_address_by_phone', 'get_address_by_phone_callback');
function get_address_by_phone_callback() {
    if (!isset($_POST['phone'])) {
        wp_send_json_error('Телефон не передан');
    }
    $phone = sanitize_text_field($_POST['phone']);
    // Нормализация телефона для поиска
    $normalized_phone = preg_replace('/\D+/', '', $phone);

    global $wpdb;
    // Ищем последний заказ с таким телефоном
    $order_id = $wpdb->get_var($wpdb->prepare(
        "SELECT post_id FROM {$wpdb->postmeta} WHERE meta_key = '_billing_phone' AND REPLACE(REPLACE(REPLACE(meta_value, '+', ''), ' ', ''), '-', '') LIKE %s ORDER BY post_id DESC LIMIT 1",
        "%{$normalized_phone}%"
    ));

    if (!$order_id) {
        wp_send_json_error('Адрес не найден');
    }

    // Получаем адресные данные из метаполей заказа
    $address = [
        'billing_address_1' => get_post_meta($order_id, '_billing_address_1', true),
        'billing_address_2' => get_post_meta($order_id, '_billing_address_2', true),
        'billing_city' => get_post_meta($order_id, '_billing_city', true),
        'billing_postcode' => get_post_meta($order_id, '_billing_postcode', true),
        'billing_state' => get_post_meta($order_id, '_billing_state', true),
        'billing_country' => get_post_meta($order_id, '_billing_country', true),
    ];

    wp_send_json_success($address);
}

2. Добавляем JavaScript для вызова AJAX при вводе телефона

add_action('wp_footer', 'enqueue_autoload_address_script');
function enqueue_autoload_address_script() {
    if (!is_checkout()) return;
    ?>
    <script type="text/javascript">
    jQuery(function($){
        var timer;
        $('#billing_phone').on('input', function() {
            clearTimeout(timer);
            var phone = $(this).val();
            if(phone.length < 5) return; // Ждем минимум 5 символов
            timer = setTimeout(function(){
                $.ajax({
                    url: '<?php echo admin_url('admin-ajax.php'); ?>',
                    type: 'POST',
                    dataType: 'json',
                    data: {
                        action: 'get_address_by_phone',
                        phone: phone
                    },
                    success: function(response) {
                        if(response.success) {
                            var addr = response.data;
                            $('#billing_address_1').val(addr.billing_address_1);
                            $('#billing_address_2').val(addr.billing_address_2);
                            $('#billing_city').val(addr.billing_city);
                            $('#billing_postcode').val(addr.billing_postcode);
                            $('#billing_state').val(addr.billing_state);
                            $('#billing_country').val(addr.billing_country);
                        }
                    }
                });
            }, 700); // задержка для снижения количества запросов
        });
    });
    </script>
    <?php
}

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

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

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

• Адрес не подгружается: проверьте правильность AJAX-запроса через инструменты разработчика, убедитесь, что action совпадает.
• Телефон не совпадает из-за формата: нормализуйте телефон в запросе и в базе одним и тем же способом, например, удаляйте все нечисловые символы.
• Поля адреса не заполняются: убедитесь, что селекторы в JavaScript совпадают с id полей WooCommerce (например, #billing_address_1).
• Кэширование мешает обновлению: отключите кэширование страницы оформления заказа или исключите AJAX-запросы из кэша.

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

• Используйте sanitize_text_field() для очистки входных данных.
• Ограничьте частоту AJAX-запросов с помощью таймера debounce (как в примере).
• Проверяйте права доступа, если нужно (например, для приватных данных).
• Кэшируйте результаты поиска адреса по телефону, если число повторных запросов велико.
• Для улучшения UX показывайте индикатор загрузки при AJAX-запросе.

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