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

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

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

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

Пошаговое решение: использование функции calculate_totals()

Для ручного контроля обновления корзины и корректного пересчета итоговой стоимости необходимо вызвать метод calculate_totals() объекта корзины WooCommerce. Этот метод пересчитывает все суммы и обновляет сессию корзины.

1. Где использовать calculate_totals()?

Чаще всего вызов нужен в следующих сценариях:

• После программного изменения количества товаров в корзине.
• После удаления товаров через кастомный код.
• После применения скидок или изменения цен через сторонние функции.

2. Пример кода для ручного обновления корзины

add_action('wp_ajax_custom_update_cart', 'custom_update_cart_quantity');
add_action('wp_ajax_nopriv_custom_update_cart', 'custom_update_cart_quantity');

function custom_update_cart_quantity() {
    $cart_item_key = sanitize_text_field($_POST['cart_item_key']);
    $new_quantity = intval($_POST['quantity']);

    if ( WC()->cart && isset(WC()->cart->cart_contents[$cart_item_key]) ) {
        WC()->cart->set_quantity($cart_item_key, $new_quantity, true); // true - пересчитать
        WC()->cart->calculate_totals(); // принудительный пересчет
        wp_send_json_success(array(
            'new_total' => WC()->cart->get_cart_total(),
            'new_subtotal' => WC()->cart->get_cart_subtotal()
        ));
    } else {
        wp_send_json_error('Cart item not found');
    }
}

В этом примере AJAX-обработчик получает ключ товара в корзине и новое количество, изменяет количество с помощью set_quantity(), затем вызывает calculate_totals() для обновления итогов.

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

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

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

• Отсутствие вызова calculate_totals(): итоговые суммы не обновляются, исправляется добавлением вызова после всех изменений.
• Изменение количества без проверки существования ключа корзины: приводит к ошибкам PHP, всегда проверяйте isset(WC()->cart->cart_contents[$cart_item_key]).
• Кэширование страниц или корзины: кэш блокирует обновление, отключайте кэш для страниц корзины и оформления заказа.
• Неправильный тип данных при передаче количества — используйте intval() для приведения к числу.

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

• Используйте sanitize_text_field() и intval() для очистки входящих данных.
• Вызывайте calculate_totals() только один раз после всех изменений корзины, чтобы избежать лишних нагрузок.
• Проверяйте наличие корзины с помощью WC()->cart для предотвращения ошибок на страницах без корзины.
• Избегайте вызова calculate_totals() на страницах, где корзина не изменяется, чтобы не влиять на производительность.

Сравнение подходов обновления корзины