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

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

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

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

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

• woocommerce_add_to_cart_validation — проверка перед добавлением товара в корзину;
• woocommerce_before_calculate_totals — изменение цены или количества товаров перед подсчетом итогов;
• woocommerce_cart_item_removed — обработка удаления товара из корзины;
• woocommerce_cart_updated — событие после обновления корзины;
• woocommerce_before_cart и woocommerce_after_cart — вывод дополнительного контента на странице корзины.

Пример: запретить добавление товара с определенным ID

add_filter('woocommerce_add_to_cart_validation', 'restrict_product_add_to_cart', 10, 3);
function restrict_product_add_to_cart($passed, $product_id, $quantity) {
    $restricted_ids = array(123, 456); // ID запрещенных товаров
    if (in_array($product_id, $restricted_ids)) {
        wc_add_notice(__('Этот товар нельзя добавить в корзину.'), 'error');
        return false;
    }
    return $passed;
}

Пошаговое решение задачи: автоматически очищать корзину при добавлении товара из другой категории

Задача: если пользователь добавляет товар из категории А, а в корзине уже есть товары из категории Б, очистить корзину перед добавлением нового товара.

Шаг 1. Получаем категорию добавляемого товара

function get_product_categories_ids($product_id) {
    return wp_get_post_terms($product_id, 'product_cat', array('fields' => 'ids')) ?: array();
}

Шаг 2. Проверяем есть ли товар из другой категории в корзине и очищаем ее

add_filter('woocommerce_add_to_cart_validation', 'clear_cart_on_category_mismatch', 10, 3);
function clear_cart_on_category_mismatch($passed, $product_id, $quantity) {
    if (WC()->cart->is_empty()) {
        return $passed;
    }

    $new_product_cats = get_product_categories_ids($product_id);
    $cart = WC()->cart->get_cart();

    foreach ($cart as $cart_item_key => $cart_item) {
        $cart_product_cats = get_product_categories_ids($cart_item['product_id']);
        // Проверяем пересечение категорий
        if (empty(array_intersect($new_product_cats, $cart_product_cats))) {
            WC()->cart->empty_cart();
            wc_add_notice(__('Корзина была очищена, так как вы добавили товар из другой категории.'), 'notice');
            break;
        }
    }

    return $passed;
}

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

• Добавьте товар из категории А в пустую корзину — товар должен добавиться без проблем.
• Добавьте товар из категории Б — корзина очистится, и останется только новый товар.
• Попробуйте добавить запрещенный товар (если применили первый пример) — должно появиться сообщение об ошибке и товар не добавится.
• Просмотрите страницу корзины и убедитесь, что уведомления отображаются корректно.

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

• Ошибка: Функция WC()->cart возвращает null или пустую корзину при проверке.
  Причина: код выполняется слишком рано, до инициализации WooCommerce.
  Решение: использовать хуки не раньше woocommerce_init или обернуть код в функцию, вызываемую при инициализированном WooCommerce.
• Ошибка: Уведомления wc_add_notice не отображаются.
  Причина: отсутствует вызов wc_print_notices() в шаблоне.
  Решение: убедитесь, что в шаблоне корзины и страниц checkout выводятся уведомления WooCommerce.
• Ошибка: Корзина не очищается или очищается полностью, даже если товары относятся к одной категории.
  Причина: логика проверки пересечения категорий неверна.
  Решение: тщательно проверьте массивы категорий и используйте функции array_intersect.

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

• Избегайте тяжелых запросов к базе данных внутри хуков, вызываемых при каждом добавлении товара.
• Для получения категорий товаров используйте кэширование, если на сайте много товаров.
• Не используйте empty_cart() без необходимости — это может негативно повлиять на UX.
• Всегда проверяйте наличие корзины и инициализацию WooCommerce перед вызовом методов WC()->cart.
• Для сложных условий контроля корзины лучше создавать отдельный плагин или использовать дочернюю тему с собственными функциями, чтобы не потерять изменения при обновлении.

Сравнение методов контроля корзины WooCommerce