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

Что такое хук woocommerce_checkout_update_order_review и зачем он нужен

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

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

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

Проверьте, что в теме или плагинах не отключён стандартный скрипт WooCommerce checkout, отвечающий за AJAX-обновления.

Пошаговое решение: реализуем динамическое обновление корзины через хук

1. Добавляем обработчик AJAX в functions.php

add_action('woocommerce_checkout_update_order_review', 'custom_update_order_review_callback', 10, 1);

function custom_update_order_review_callback($posted_data) {
    parse_str($posted_data, $output);
    // Например, меняем цену в зависимости от выбранного параметра
    if (!empty($output['custom_option'])) {
        $custom_option = sanitize_text_field($output['custom_option']);
        // Логика изменения цены или добавления товара
        // Для примера добавим фейковый товар (или изменим цену существующего)
        // Здесь можно использовать WC()->cart API
    }
    // Обязательно возвращаем корректный ответ
    wp_send_json_success();
}

2. Добавляем поле в форму оформления заказа для теста

add_action('woocommerce_before_order_notes', 'custom_checkout_field');
function custom_checkout_field($checkout) {
    echo '<div id="custom_checkout_field">';
    woocommerce_form_field( 'custom_option', array(
        'type'          => 'select',
        'class'         => array('custom-option-class form-row-wide'),
        'label'         => __('Custom Option'),
        'options'       => array(
            '' => __('Select an option', 'woocommerce'),
            'option1' => __('Option 1', 'woocommerce'),
            'option2' => __('Option 2', 'woocommerce'),
        ),
    ), $checkout->get_value( 'custom_option' ));
    echo '</div>';
}

3. Тестируем динамическое обновление

При изменении поля custom_option WooCommerce автоматически отправит AJAX запрос, вызовет хук woocommerce_checkout_update_order_review, где можно обработать логику и вернуть обновлённые данные корзины.

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

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

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

• Обработчик не вызывается: Возможно, установлен приоритет хука слишком низкий или неправильное имя функции. Используйте add_action('woocommerce_checkout_update_order_review', 'your_function_name', 10, 1);
• Неверный формат данных в $posted_data: $posted_data — это URL-закодированная строка, её нужно распарсить через parse_str() для получения массива.
• Изменения не отражаются в корзине: Используйте API WC()->cart для изменения содержимого корзины и вызывайте методы для пересчёта totals, например, WC()->cart->calculate_totals();
• Проблемы с кэшированием AJAX: Проверьте, что на сайте не кэшируются AJAX-запросы WooCommerce.

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

• В обработчике всегда проверяйте и фильтруйте входящие данные: sanitize_text_field(), esc_html().
• Не выполняйте тяжёлые операции в AJAX-обработчике, чтобы не замедлять оформление заказа.
• Используйте nonce поля, если добавляете свои AJAX действия вне стандартных WooCommerce хуков.
• При изменении корзины вызывайте методы WC()->cart->calculate_totals() и WC()->cart->maybe_set_cart_cookies() для корректного обновления сессии.

Сравнение способов динамического обновления корзины