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

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

В WooCommerce часто возникает необходимость проверить свойства товара или изменить параметры перед тем, как товар будет добавлен в корзину. Например, запретить добавление товара, если он не соответствует определённым критериям (например, минимальное количество, наличие на складе, уникальность), или динамически изменить цену или метаданные.

Без правильного использования хуков, таких проверок будет недостаточно или они будут выполняться некорректно, что приведёт к ошибкам в логике магазина.

Основы использования хука woocommerce_before_add_to_cart

В WooCommerce существует несколько хуков, связанных с добавлением товара в корзину. Один из наиболее подходящих для проверки — woocommerce_before_add_to_cart, который вызывается непосредственно перед добавлением товара.

Однако, на практике чаще используется фильтр woocommerce_add_to_cart_validation, который позволяет отменить добавление товара при возвращении false.

Пример базовой проверки с отменой добавления товара

add_filter('woocommerce_add_to_cart_validation', 'custom_check_before_add_to_cart', 10, 3);
function custom_check_before_add_to_cart($passed, $product_id, $quantity) {
    // Проверяем: запрещаем добавлять товар с ID 123
    if ($product_id == 123) {
        wc_add_notice('Этот товар нельзя добавить в корзину.', 'error');
        return false; // отменяем добавление
    }
    return $passed;
}

В этом примере, если пользователь пытается добавить товар с ID 123, добавление будет отменено, а на фронтенде появится сообщение об ошибке.

Как изменить параметры товара перед добавлением

Для динамического изменения параметров, например, цены, можно использовать хук woocommerce_before_calculate_totals, но если нужно изменить данные непосредственно во время добавления, можно использовать woocommerce_add_cart_item_data.

Пример изменения цены товара при добавлении в корзину

add_filter('woocommerce_add_cart_item_data', 'custom_modify_cart_item_data', 10, 3);
function custom_modify_cart_item_data($cart_item_data, $product_id, $variation_id) {
    if ($product_id == 456) {
        // Добавим пользовательское поле для изменения цены
        $cart_item_data['custom_price'] = 500; // фиксированная цена
    }
    return $cart_item_data;
}

add_action('woocommerce_before_calculate_totals', 'custom_apply_custom_price', 20, 1);
function custom_apply_custom_price($cart) {
    if (is_admin() && !defined('DOING_AJAX')) return;
    foreach ($cart->get_cart() as $cart_item_key => $cart_item) {
        if (isset($cart_item['custom_price'])) {
            $cart_item['data']->set_price($cart_item['custom_price']);
        }
    }
}

Этот код позволяет установить фиксированную цену 500 для товара с ID 456 при добавлении в корзину.

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

• Попробуйте добавить товар с ID 123 — добавление должно быть запрещено, а на странице корзины появится сообщение об ошибке.
• Добавьте товар с ID 456 и проверьте, что цена в корзине равна 500, независимо от базовой цены товара.
• Проверьте регистрацию ошибок в консоли, чтобы убедиться, что сообщения об ошибках выводятся корректно.
• Очистите кэш и проверьте работу на разных браузерах и сессиях.

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

• Ошибка: Добавление товара не отменяется, несмотря на возврат false в фильтре woocommerce_add_to_cart_validation.
  Причина: Возможно, другие плагины или тема перезаписывают поведение. Проверьте при отключённых сторонних плагинах.
• Ошибка: Цена не меняется в корзине при использовании woocommerce_before_calculate_totals.
  Причина: Не вызван метод set_price() объекта товара, или код вызывается в админке (нужно исключить админ-запросы).
• Ошибка: Сообщения об ошибках не отображаются на фронте.
  Решение: Убедитесь, что в шаблоне есть вывод wc_print_notices() или аналогичный.

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

• Добавляйте проверки в фильтры с минимальной нагрузкой — избегайте тяжелых запросов в woocommerce_add_to_cart_validation, лучше кэшируйте данные заранее.
• Используйте nonce и проверяйте права пользователя при работе с пользовательскими данными, особенно если модифицируете корзину через AJAX.
• Для сложных проверок и изменений лучше использовать дочернюю тему или отдельный плагин, чтобы не потерять изменения при обновлении WooCommerce или темы.

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