Как запретить создание дублирующихся вариантов продуктов в WooCommerce

Диагностика проблемы с дублирующимися вариантами

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

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

Пошаговое решение: валидация создания вариаций через хук WooCommerce

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

Добавьте следующий код в файл functions.php вашей темы или в отдельный плагин:

add_action('woocommerce_admin_process_product_object', 'block_duplicate_variations', 10, 1);
function block_duplicate_variations($product) {
    if ($product->get_type() !== 'variable') {
        return;
    }

    $variations = $product->get_children();
    $combinations = [];

    foreach ($variations as $variation_id) {
        $variation = wc_get_product($variation_id);
        $attributes = $variation->get_attributes();
        ksort($attributes); // сортируем для стабильности
        $key = json_encode($attributes);

        if (isset($combinations[$key])) {
            // Дублирование найдено - выбрасываем ошибку
            throw new Exception('Ошибка: обнаружены дублирующиеся варианты с одинаковыми атрибутами.');
        }
        $combinations[$key] = true;
    }
}

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

Что делать, если вариации создаются программно

Если варианты добавляются через API или сторонние скрипты, необходимо добавить проверку перед созданием вариации. Пример проверки:

function check_variation_exists($product_id, $new_attributes) {
    $product = wc_get_product($product_id);
    if (!$product || $product->get_type() !== 'variable') {
        return false;
    }

    $variations = $product->get_children();
    ksort($new_attributes);
    $new_key = json_encode($new_attributes);

    foreach ($variations as $variation_id) {
        $variation = wc_get_product($variation_id);
        $attrs = $variation->get_attributes();
        ksort($attrs);
        if (json_encode($attrs) === $new_key) {
            return true; // такой вариант уже есть
        }
    }
    return false;
}

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

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

1. Перейдите в админку WordPress > Товары и откройте переменный продукт для редактирования.
2. Попробуйте добавить вариацию с набором атрибутов, который уже существует.
3. При сохранении вы увидите ошибку и сохранение будет заблокировано.
4. Если создаете вариации программно, убедитесь, что функция check_variation_exists возвращает true при попытке добавить дубликат.

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

• Ошибка: "Call to undefined function wc_get_product"
  Причина: код выполняется вне окружения WooCommerce. Решение: убедитесь, что WooCommerce активирован и код вызывается после его загрузки, например, через хук plugins_loaded.
• Дублирование все еще появляется
  Причина: вариации создаются не через админку, а напрямую в базе или через сторонние плагины без проверки.
  Решение: добавьте проверку в места создания вариаций программно, как показано выше.
• Ошибка не отображается корректно
  Причина: исключение в хуке не всегда выводится стандартно.
  Решение: для лучшей UX можно использовать wc_add_notice и фильтры в админке, но это сложнее. В простом варианте исключение остановит сохранение.

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

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

Сравнение способов борьбы с дублированием вариаций

Способ	Плюсы	Минусы
Валидация через хук сохранения (исключение)	Простота реализации, работает сразу при сохранении	Ошибка выводится стандартно, может быть неудобно для пользователя
Проверка перед программным созданием вариации	Предотвращает дублирование на уровне кода, гибко	Требует интеграции во все места создания вариаций
Использование плагинов (например, для кастомизации вариаций)	Может иметь готовые решения и UI	Дополнительная нагрузка, риск конфликтов