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

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

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

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

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

function has_cart_item_with_attribute($taxonomy, $term_slug) {
    foreach (WC()->cart->get_cart() as $cart_item) {
        $product = $cart_item['data'];
        // Проверяем глобальные атрибуты
        if (taxonomy_exists($taxonomy)) {
            $terms = wp_get_post_terms($product->get_id(), $taxonomy, array('fields' => 'slugs'));
            if (in_array($term_slug, $terms)) {
                return true;
            }
        }
        // Проверяем пользовательские атрибуты
        $attributes = $product->get_attributes();
        if (isset($attributes[$taxonomy])) {
            $attribute = $attributes[$taxonomy];
            if ($attribute->is_taxonomy()) {
                $terms = wp_get_post_terms($product->get_id(), $taxonomy, array('fields' => 'slugs'));
                if (in_array($term_slug, $terms)) {
                    return true;
                }
            } else {
                // Локальные атрибуты — строки
                $values = explode('|', $attribute->get_options());
                if (in_array($term_slug, array_map('trim', $values))) {
                    return true;
                }
            }
        }
    }
    return false;
}

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

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

add_action('woocommerce_checkout_process', 'block_checkout_for_specific_attributes');
function block_checkout_for_specific_attributes() {
    // Задайте таксономию атрибута и термин, который запрещает оплату
    $attribute_taxonomy = 'pa_special-flag'; // например, pa_special-flag
    $forbidden_term = 'no-payment'; // слаг термина

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

Объяснение:

• В функции block_checkout_for_specific_attributes вызывается проверка на наличие товара с нужным атрибутом.
• Если условие истинно, вызывается wc_add_notice с типом error, что блокирует дальнейшее оформление заказа.

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

Чтобы проверить, что блокировка работает:

1. Добавьте в магазин товар с нужным атрибутом (например, с атрибутом pa_special-flag = no-payment).
2. Положите такой товар в корзину.
3. Попытайтесь оформить заказ — на странице оформления должна появиться ошибка с сообщением из wc_add_notice и оформление будет невозможно.
4. Добавьте в корзину товар без этого атрибута — оплата должна пройти без ошибок.

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

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

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

• Кэширование не рекомендуется для страниц оформления заказа, так как корзина должна проверяться в реальном времени.
• Минимизируйте нагрузку на базу данных, кэшируя результаты проверки атрибутов при необходимости, если корзина большая.
• Всегда валидируйте данные и используйте стандартные функции WooCommerce для работы с продуктами и атрибутами, чтобы избежать потенциальных уязвимостей.
• Для расширенного контроля логики оплаты рассмотрите возможность интеграции с плагинами типа Clearfy Pro (https://wpshop.ru/plugins/clearfy?utm_source=wpkit.ru&utm_medium=article&utm_campaign=woocommerce-zablokirovat-oplatu-pri-nalichii-tovarov-po-attributam) для оптимизации и безопасности.

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