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

Диагностика задачи: зачем автоматизировать изменения товаров в корзине WooCommerce

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

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

Основные хуки WooCommerce для изменения товаров в корзине

Для решения задачи чаще всего применяются:

• woocommerce_before_calculate_totals — изменить цену товара перед пересчётом суммы корзины.
• woocommerce_add_cart_item_data — изменить данные при добавлении товара в корзину.
• woocommerce_cart_item_quantity — изменить отображаемое количество товара.
• woocommerce_get_cart_item_from_session — восстановить или изменить данные товара при загрузке сессии.

Пример: автоматическое снижение цены на 10% для товаров категории «sale»

add_action('woocommerce_before_calculate_totals', 'apply_discount_to_sale_category', 20, 1);
function apply_discount_to_sale_category($cart) {
    if (is_admin() && !defined('DOING_AJAX')) return;
    foreach ($cart->get_cart() as $cart_item_key => $cart_item) {
        $product = $cart_item['data'];
        if (has_term('sale', 'product_cat', $product->get_id())) {
            $original_price = $product->get_regular_price();
            $discounted_price = $original_price * 0.9;
            $product->set_price($discounted_price);
        }
    }
}

Этот код снижает цену на 10% для всех товаров, принадлежащих категории «sale». Важно использовать хук с приоритетом не выше 20, чтобы не конфликтовать с другими плагинами.

Пошаговое решение задачи по изменению товаров в корзине

1. Определите условия изменения (категория, метаполя, пользовательские данные).
2. Выберите правильный хук (чаще всего woocommerce_before_calculate_totals для изменения цен).
3. Реализуйте функцию, которая циклично обрабатывает товары в корзине.
4. В функции меняйте параметры объекта товара ($cart_item['data']).
5. Добавьте проверки, чтобы исключить админ-запросы и AJAX, если не требуется.
6. Протестируйте изменения в разных сценариях (добавление, удаление, обновление количества).

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

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

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

• Изменение цены без проверки AJAX/админки: приводит к ошибкам при обновлении или в админке. Решение — добавьте проверку if (is_admin() && !defined('DOING_AJAX')) return;.
• Изменение свойства объекта товара напрямую вне хука: может не срабатывать, поскольку WooCommerce кеширует данные. Используйте woocommerce_before_calculate_totals.
• Ошибки с типами данных: цена должна быть числом с плавающей точкой, используйте floatval() при вычислениях.
• Отсутствие обновления корзины после изменения: убедитесь, что изменения происходят до подсчёта итогов, иначе пользователь увидит старые данные.

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

• Не храните изменённые цены в метаполях товара, чтобы не нарушить логику WooCommerce.
• Используйте кеширование условий (например, категории товаров), если корзина большая, чтобы не делать лишних запросов.
• Избегайте сложной логики в хуках, вызываемых часто — это замедляет загрузку страницы корзины.
• Проверяйте совместимость с плагинами кэширования и оптимизации, чтобы изменения цен отображались корректно.

Сравнение вариантов реализации автоматических изменений товаров в корзине WooCommerce