WooCommerce: как заблокировать оплату при наличии товаров с определёнными атрибутами в корзине

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

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

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

WooCommerce хранит данные о товарах и их атрибутах в объекте WC_Cart. Для проверки можно перебрать все позиции корзины и получить атрибуты товаров через функции API WooCommerce.

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

function has_product_with_attribute( $attribute_name, $attribute_value ) {
    foreach ( WC()->cart->get_cart() as $cart_item ) {
        $product = $cart_item['data'];
        $attributes = $product->get_attributes();

        if ( isset( $attributes[ $attribute_name ] ) ) {
            $attr = $attributes[ $attribute_name ];
            // Проверяем, является ли атрибут вариативным или пользовательским
            if ( $attr->is_taxonomy() ) {
                $terms = wp_get_post_terms( $product->get_id(), $attr->get_name(), array('fields' => 'names') );
                if ( in_array( $attribute_value, $terms, true ) ) {
                    return true;
                }
            } else {
                if ( $attr->get_options() && in_array( $attribute_value, $attr->get_options(), true ) ) {
                    return true;
                }
            }
        }
    }
    return false;
}

Пошаговое решение: блокируем оплату в WooCommerce

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

add_action( 'woocommerce_check_cart_items', 'block_payment_for_specific_attribute' );
function block_payment_for_specific_attribute() {
    $attribute_name = 'pa_custom_attribute'; // slug атрибута, например pa_color
    $attribute_value = 'Запрещённое значение'; // значение атрибута

    if ( has_product_with_attribute( $attribute_name, $attribute_value ) ) {
        wc_add_notice( 'Оплата невозможна: в корзине есть товары с запрещённым атрибутом.', 'error' );
    }
}

Подключение проверки атрибутов

В функциях мы используем pa_custom_attribute — это slug пользовательского атрибута, который можно узнать в админке WooCommerce в настройках атрибутов товаров. Аналогично укажите нужное значение.

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

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

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

• Неправильный slug атрибута: убедитесь, что в коде указан именно slug атрибута (например, pa_color), а не его название.
• Проблемы с вариативными товарами: атрибуты вариативных товаров хранятся в терминах таксономии, проверьте, что используете правильный метод получения значений.
• Кэширование корзины: если изменения не применяются сразу, очистите кэш сайта и браузера.
• Отсутствие проверки перед использованием объекта WC(): убедитесь, что WooCommerce загружен (например, вызов функций внутри хуков, после инициализации WooCommerce).

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

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

Сравнение способов реализации блокировки оплаты