WooCommerce: как избежать проблем с неактивными вариантами в корзине

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

Проблема с неактивными (недоступными для покупки) вариантами товаров в корзине возникает, когда покупатель добавляет товар с определёнными атрибутами, которые затем становятся недоступными (например, размер или цвет снят с продажи). Это приводит к ошибкам при оформлении заказа и ухудшает пользовательский опыт.

Для диагностики выполните следующие шаги:

• Добавьте в корзину товар с вариацией, которую вы планируете сделать недоступной.
• Измените статус вариации в админке WooCommerce на «неактивный» или измените наличие на «нет в наличии».
• Перейдите в корзину на фронтенде и проверьте, отображается ли товар корректно или возникает ошибка.
• Активируйте логирование WooCommerce (WooCommerce > Статус > Логи) и проверьте наличие ошибок, связанных с вариациями.

Причины возникновения проблемы

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

Пошаговое решение: автоматическое удаление неактивных вариантов из корзины

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

1. Добавляем проверку вариаций в корзине

add_action('woocommerce_check_cart_items', 'remove_inactive_variations_from_cart');
function remove_inactive_variations_from_cart() {
    foreach (WC()->cart->get_cart() as $cart_item_key => $cart_item) {
        if (isset($cart_item['variation_id']) && $cart_item['variation_id'] > 0) {
            $variation_id = $cart_item['variation_id'];
            $variation = wc_get_product($variation_id);
            if (!$variation || !$variation->is_purchasable() || !$variation->is_in_stock()) {
                WC()->cart->remove_cart_item($cart_item_key);
                wc_add_notice(__('В корзине был удалён недоступный вариант товара.'), 'notice');
            }
        }
    }
}

2. Проверяем наличие и статус вариации

Функция wc_get_product() получает объект вариации, у которого проверяем методы is_purchasable() и is_in_stock(). Если один из них возвращает false, вариант удаляется из корзины.

3. Очистка кэша корзины

Если у вас активированы плагины кеширования (например, WP Super Cache, W3 Total Cache или LiteSpeed Cache), убедитесь, что страница корзины исключена из кеша. Это критично для актуализации состояния вариаций в корзине.

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

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

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

• Функция не срабатывает — корзина не очищается: проверьте, что хук woocommerce_check_cart_items подключён корректно и код не конфликтует с другими плагинами.
• Неактивные варианты не удаляются из-за кэширования: отключите кэширование для страницы корзины или настройте исключения в плагине кеширования.
• Удаление вариаций мешает пользовательскому потоку: добавьте информативные уведомления через wc_add_notice() для пользователя.
• Проблемы с атрибутами и вариациями после импорта: проверьте, что вариации корректно импортированы и имеют правильный статус «в наличии».

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

• Используйте wc_get_product() вместо прямого обращения к базе данных для корректного получения статуса вариации.
• Для больших каталогов и загрузок корзины с большим количеством товаров добавьте кэширование результатов проверки в течение одного запроса, чтобы снизить нагрузку.
• Всегда делайте резервное копирование сайта перед внесением изменений в функции, связанные с корзиной и заказами.
• Регулярно обновляйте WooCommerce и плагины, чтобы избежать конфликтов и уязвимостей.

Сравнение вариантов решения проблемы