WooCommerce: как запретить добавление дубликатов товаров в корзину

Проблема: почему в корзине появляются дубликаты товаров

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

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

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

Чтобы проверить, есть ли дубликаты товаров в корзине, можно добавить следующий код в файл functions.php активной темы или в кастомный плагин:

add_action('woocommerce_before_cart', function() {
    $cart = WC()->cart->get_cart();
    $items = [];
    foreach ($cart as $cart_item_key => $cart_item) {
        $product_id = $cart_item['product_id'];
        if (isset($items[$product_id])) {
            echo '<div style="color:red;">Дубликат товара в корзине: ' . get_the_title($product_id) . '</div>';
        } else {
            $items[$product_id] = true;
        }
    }
});

Этот код выведет предупреждение на странице корзины, если обнаружит более одного товара с одинаковым ID.

Пошаговое решение: запрет добавления дубликатов товаров в корзину

Для решения задачи нужно перехватывать добавление товара в корзину и проверять, есть ли уже такой товар с идентичными параметрами. Если есть, то блокировать добавление или вместо создания новой строки увеличивать количество.

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

add_filter('woocommerce_add_to_cart_validation', function($passed, $product_id, $quantity, $variation_id = 0, $variations = []) {
    foreach (WC()->cart->get_cart() as $cart_item) {
        if ($variation_id ? $cart_item['variation_id'] === $variation_id : $cart_item['product_id'] === $product_id) {
            wc_add_notice('Этот товар уже добавлен в корзину.', 'error');
            return false;
        }
    }
    return $passed;
}, 10, 5);

Если вы хотите, чтобы при добавлении дубликата увеличивалось количество товара, а не создавалась новая строка, то используйте стандартное поведение WooCommerce без кастомных перезаписей.

Проверка результата

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

Частые ошибки и причины

• Ошибка: Сообщение блокируется, но дубликаты все равно появляются.
  Причина: Конфликт с другими плагинами, которые изменяют логику корзины (например, кастомные расширения WooCommerce). Проверьте последовательность хуков и совместимость.
• Ошибка: Код не срабатывает для вариаций товаров.
  Причина: В коде не учтены вариации — нужно сравнивать variation_id, а не только product_id.
• Ошибка: Сообщение об ошибке не выводится.
  Причина: Возможно, тема не поддерживает wc_print_notices() или уведомления отключены. Добавьте в шаблон корзины <?php wc_print_notices(); ?>.

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

• Не используйте тяжелые циклы и запросы в хук woocommerce_add_to_cart_validation, чтобы не замедлять добавление товара.
• Проверяйте, что сравниваете именно нужные параметры товара (ID, варианции, атрибуты), чтобы избежать ложных срабатываний.
• Используйте транслируемые сообщения wc_add_notice для корректной локализации и поддержки тем.

Альтернативные варианты реализации