WooCommerce: правильное удаление вариантов товаров через код

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

В WooCommerce часто возникает необходимость программно удалить варианты товаров (product variations), например, при очистке каталога или автоматизации управления ассортиментом. При этом многие сталкиваются с проблемами: удаление происходит некорректно, остаются «битые» записи в базе, или же удаляются только родительские товары без вариаций. Причина в том, что вариации — это типы записей product_variation, привязанные к родительскому товару variable.

Неправильное удаление может привести к ошибкам в админке, некорректному отображению товаров и даже к падению производительности из-за мусора в базе данных.

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

Пошаговое решение

Для корректного удаления вариантов нужно:

1. Получить ID родительского товара (типа variable).
2. Выбрать все дочерние записи с типом product_variation, у которых post_parent равен ID родительского товара.
3. Удалить варианты через функцию wp_delete_post() с параметром $force_delete = true, чтобы удалить записи полностью, минуя корзину.
4. При необходимости удалить сам родительский товар.

Пример кода для удаления всех вариантов конкретного товара

function delete_product_variations( $parent_product_id ) {
    $args = array(
        'post_type'      => 'product_variation',
        'post_status'    => array('private', 'publish'),
        'numberposts'    => -1,
        'post_parent'    => $parent_product_id
    );

    $variations = get_posts( $args );

    foreach ( $variations as $variation ) {
        wp_delete_post( $variation->ID, true ); // Полное удаление
    }
}

Если нужно удалить варианты по условию, например, по метаданным, можно добавить meta_query в аргументы get_posts().

Удаление вариаций по условию и удаление родительского товара

function delete_variations_and_parent_by_condition() {
    $args = array(
        'post_type'      => 'product_variation',
        'post_status'    => array('private', 'publish'),
        'numberposts'    => -1,
        'meta_query'     => array(
            array(
                'key'     => '_price',
                'value'   => 1000,
                'compare' => '<',
                'type'    => 'NUMERIC'
            )
        )
    );

    $variations = get_posts( $args );
    $parents_to_check = array();

    foreach ( $variations as $variation ) {
        $parent_id = $variation->post_parent;
        wp_delete_post( $variation->ID, true );
        $parents_to_check[ $parent_id ] = true;
    }

    // Проверяем родительские товары: если у них не осталось вариантов, удаляем и их
    foreach ( array_keys( $parents_to_check ) as $parent_id ) {
        $remaining = get_posts( array(
            'post_type'   => 'product_variation',
            'numberposts' => 1,
            'post_parent' => $parent_id
        ) );

        if ( empty( $remaining ) ) {
            wp_delete_post( $parent_id, true );
        }
    }
}

Как проверить, что удаление сработало

• В админке WooCommerce проверьте список товаров: удалённые варианты должны исчезнуть.
• В базе данных (таблица wp_posts) можно выполнить SQL-запрос: SELECT COUNT(*) FROM wp_posts WHERE post_parent = {ID_товара} AND post_type = 'product_variation'; — результат должен быть 0.
• Проверьте отсутствие ошибок и предупреждений в логах сервера и WooCommerce.
• Если вы используете кеширование, очистите кеш после удаления.

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

• Удаление только родительского товара без вариантов: варианты остаются в базе, что приводит к ошибкам. Решение — удалять сначала вариации, затем родителя.
• Использование wp_trash_post() вместо wp_delete_post(): вариации попадают в корзину и не удаляются полностью. Лучше использовать wp_delete_post($id, true).
• Пропуск проверки статуса вариаций: некоторые варианты могут иметь статус private или draft, их тоже надо учитывать.
• Отсутствие очистки кеша: кешированные данные могут показывать устаревшие варианты.

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

• Чтобы не перегружать сервер, если вариантов много, удаляйте партиями, например, по 50 штук за запрос.
• Всегда делайте резервную копию базы перед массовым удалением.
• Используйте WP-CLI для массовых операций, если доступно — это надежнее и быстрее.
• Используйте транзакции базы данных, если подключаетесь напрямую, чтобы избежать частичного удаления.
• Проверяйте права пользователя, выполняющего удаление, чтобы избежать несанкционированных действий.

Сравнение способов удаления вариантов: плагин vs код