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

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

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

Типичные признаки проблемы:

• Общая сумма в блоке корзины не меняется после ввода купона или изменения способа доставки.
• Не обновляются дополнительные сборы или налоги, зависящие от адреса.
• Нужно вручную обновлять страницу, чтобы увидеть изменения.

Что делает хук woocommerce_checkout_update_order_review

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

Использование этого хука позволяет динамически менять отображение корзины без перезагрузки всей страницы.

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

1. Добавление обработчика на PHP

В functions.php вашей темы или в плагине добавьте следующий код:

add_action('woocommerce_checkout_update_order_review', 'custom_update_order_review_callback', 10);
function custom_update_order_review_callback($posted_data) {
    // Разбор сериализованных данных, которые отправляет AJAX
    parse_str($posted_data, $output);

    // Пример: если нужно динамически добавить скидку при определенном условии
    if (isset($output['billing_postcode']) && $output['billing_postcode'] === '12345') {
        WC()->cart->add_fee('Специальная скидка', -10);
    } else {
        // Удаляем все дополнительные сборы, если условие не выполнено
        WC()->cart->remove_fee('Специальная скидка');
    }

    // Обязательно пересчитать корзину
    WC()->cart->calculate_totals();
}

2. Обновление области корзины на стороне клиента

WooCommerce автоматически обновляет блок .woocommerce-checkout-review-order после AJAX-запроса этого хука, но если вы хотите добавить свои данные или кастомные элементы, нужно использовать JS.

Пример простого JavaScript, который ловит событие обновления и логирует сообщение:

jQuery(function($) {
    $(document.body).on('updated_checkout', function() {
        console.log('Checkout обновлен, корзина актуальна');
        // Здесь можно обновить свои кастомные элементы
    });
});

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

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

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

• Не вызывается пересчет корзины: забудьте вызвать WC()->cart->calculate_totals() после изменения сборов или скидок — сумма не обновится.
• Ошибка разбора данных: AJAX отправляет данные в сериализованном виде, используйте parse_str() для их корректного разбора.
• Функция добавления/удаления сборов не работает: убедитесь, что название сбора в remove_fee() совпадает с тем, что вы добавляете.
• Кастомные JS-события не срабатывают: проверьте, что скрипт загружается на странице и jQuery доступен.

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

• Не используйте пользовательские данные напрямую без проверки — при необходимости валидируйте и фильтруйте $posted_data.
• Не добавляйте тяжелые вычисления или запросы в обработчик хука — это может замедлить AJAX-ответ и ухудшить UX.
• Если кастомных данных много, рассмотрите кэширование результатов или использование transient API для частично статичных данных.
• Для поддержки производительности чаще проверяйте, что условия действительно меняются, чтобы не запускать пересчет без нужды.

Сравнение способов обновления корзины на странице оформления заказа