WooCommerce: как удалить варианты товаров на основе атрибутов

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

В интернет-магазинах на WooCommerce часто появляется потребность автоматически удалить из базы определённые варианты товаров (вариации) при выполнении условий по атрибутам. Например, нужно удалить все варианты с цветом "красный" или размером "XL". Это важно для поддержания актуального ассортимента, экономии ресурсов базы и корректного отображения в каталоге.

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

1. Получение ID вариаций с нужными атрибутами

В WooCommerce вариации — это тип записей product_variation с метаданными атрибутов формата attribute_pa_{slug}. Для поиска вариантов по атрибуту используем WP_Query и мета-запросы.

$attribute_name = 'pa_color'; // slug атрибута без 'attribute_'
$attribute_value = 'red'; // значение атрибута

$args = [
    'post_type'      => 'product_variation',
    'posts_per_page' => -1,
    'meta_query'     => [
        [
            'key'     => 'attribute_' . $attribute_name,
            'value'   => $attribute_value,
            'compare' => '=',
        ],
    ],
    'fields' => 'ids',
];

$variations = get_posts($args);

2. Удаление найденных вариантов

После получения ID вариаций можно их удалить программно. Для этого используем wp_delete_post() с параметром $force_delete = true чтобы удалить без помещения в корзину.

foreach ($variations as $variation_id) {
    wp_delete_post($variation_id, true);
}

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

Чтобы убедиться, что варианты удалены:

• В админке WooCommerce в разделе «Товары» откройте родительский товар и проверьте список вариаций — удалённые варианты больше не должны отображаться.
• Повторно выполните тот же WP_Query для поиска вариантов с заданным атрибутом — запрос должен вернуть пустой массив.
• Проверьте фронтенд сайта, чтобы товары с удалёнными вариантами не показывали эти опции в выборе.

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

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

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

• Перед массовым удалением сделайте резервную копию базы данных.
• Для больших магазинов с тысячами вариаций выполняйте удаление пакетами (например, по 100 записей), чтобы избежать таймаутов.
• Запускайте удаление через WP-CLI или WP-Cron с ограничением нагрузки.
• После удаления вызовите wc_delete_product_transients($product_id) для очистки кэша вариаций родительского товара.

Пример функции для удаления вариантов по атрибуту с очисткой кэша

function wc_delete_variations_by_attribute($product_id, $attribute_name, $attribute_value) {
    $args = [
        'post_type'      => 'product_variation',
        'posts_per_page' => -1,
        'post_parent'    => $product_id,
        'meta_query'     => [
            [
                'key'     => 'attribute_' . $attribute_name,
                'value'   => $attribute_value,
                'compare' => '=',
            ],
        ],
        'fields' => 'ids',
    ];

    $variations = get_posts($args);

    foreach ($variations as $variation_id) {
        wp_delete_post($variation_id, true);
    }

    // Очистка кэша вариаций
    wc_delete_product_transients($product_id);
}

// Пример использования:
wc_delete_variations_by_attribute(1234, 'pa_color', 'red');

Сравнение вариантов решения