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

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

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

Как понять, что блокировка нужна именно по атрибутам?

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

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

Основной способ — использовать фильтр woocommerce_checkout_process, который позволяет добавить проверку перед финальной оплатой.

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

add_action('woocommerce_checkout_process', 'block_checkout_if_attribute_present');
function block_checkout_if_attribute_present() {
    foreach ( WC()->cart->get_cart() as $cart_item ) {
        $product = $cart_item['data'];
        $attributes = $product->get_attributes();
        if ( ! empty( $attributes['pa_color'] ) ) { // pa_ – префикс атрибута
            $values = wc_get_product_terms( $product->get_id(), 'pa_color', array( 'fields' => 'names' ) );
            if ( in_array( 'Red', $values ) ) {
                wc_add_notice( 'Оплата недоступна: в корзине есть товар с запрещённым цветом Red.', 'error' );
                break;
            }
        }
    }
}

Обратите внимание на префикс pa_ — он нужен для всех атрибутов созданных через админку WooCommerce.

Расширение проверки на несколько атрибутов и значений

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

add_action('woocommerce_checkout_process', 'block_checkout_multiple_attributes');
function block_checkout_multiple_attributes() {
    $block_conditions = [
        'pa_color' => ['Red', 'Black'],
        'pa_material' => ['Plastic']
    ];

    foreach ( WC()->cart->get_cart() as $cart_item ) {
        $product = $cart_item['data'];
        foreach ( $block_conditions as $taxonomy => $forbidden_values ) {
            $terms = wc_get_product_terms( $product->get_id(), $taxonomy, array( 'fields' => 'names' ) );
            if ( array_intersect( $terms, $forbidden_values ) ) {
                wc_add_notice( 'Оплата недоступна: в корзине есть товар с запрещённым атрибутом.', 'error' );
                return;
            }
        }
    }
}

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

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

Для отладки можно временно вывести список атрибутов каждого товара через error_log(print_r($attributes, true)) в файле functions.php.

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

• Неверный префикс атрибута: в WooCommerce все пользовательские атрибуты начинаются с pa_. Проверьте это в админке -> Товары -> Атрибуты.
• Ошибки в названиях значений: значения атрибутов чувствительны к регистру и пробелам. Используйте точные имена или примените strtolower() для сравнения.
• Проверка вариаций: если товары — вариации, атрибуты нужно получать из вариации, а не из родительского товара.
• Кэш корзины: иногда кэш мешает обновлению данных, очистите кэш или тестируйте в режиме инкогнито.

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

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

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