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

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

В WooCommerce варианты товаров (variations) являются дочерними записями для переменных товаров. Удаление вариаций вручную через админку или через стандартные функции WordPress не всегда эффективно, так как могут остаться метаданные, связи с заказами и кэшированные данные. Это приводит к ошибкам и некорректному отображению на фронтенде.

Типичные симптомы:

• Варианты товара всё ещё отображаются в каталоге или корзине после удаления.
• Ошибки при обновлении запасов или при оформлении заказа.
• Отсутствие возможности повторно создать вариант с тем же атрибутом.

Пошаговое решение удаления вариантов товаров через код

1. Получение ID вариантов для удаления

Для начала нам нужна функция, которая по ID переменного товара вернёт ID всех его вариантов.

function get_variation_ids_by_parent( $parent_id ) {
    $args = [
        'post_parent' => $parent_id,
        'post_type'   => 'product_variation',
        'fields'      => 'ids',
        'numberposts' => -1
    ];
    return get_posts( $args );
}

2. Удаление вариаций корректно с очисткой метаданных

Далее удаляем варианты через wp_delete_post с параметром true для полного удаления, чтобы не оставалось записей в базе.

function delete_product_variations( $parent_id ) {
    $variation_ids = get_variation_ids_by_parent( $parent_id );
    foreach ( $variation_ids as $variation_id ) {
        wp_delete_post( $variation_id, true );
    }
}

Вызов функции:

delete_product_variations( 123 ); // 123 - ID переменного товара

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

• В админке в списке вариаций выбранного товара убедитесь, что вариации отсутствуют.
• На фронтенде товара проверьте, что варианты не отображаются в селекторах.
• В базе данных (таблица wp_posts) по запросу SELECT * FROM wp_posts WHERE post_parent = 123 AND post_type = 'product_variation' не должно быть записей.

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

• Вариации не удаляются полностью: проверьте, используется ли параметр true в wp_delete_post, без него посты попадают в корзину и могут сохранять связь.
• Ошибка доступа при удалении: убедитесь, что функция вызывается в контексте с правами администратора или с необходимыми capability.
• Остаточные метаданные: если метаданные не удаляются, можно дополнительно очистить таблицу wp_postmeta через WP-CLI или вручную.

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

• Перед удалением всегда делайте резервную копию базы данных, чтобы избежать потери данных.
• Если вариантов много, удаляйте пачками по 50-100 штук, чтобы избежать таймаута PHP.
• Для массовых операций используйте WP-CLI — это быстрее и надёжнее.
• Очищайте кеш WooCommerce и объектный кеш после удаления, чтобы изменения сразу отобразились на сайте.

Сравнение методов удаления вариантов WooCommerce

Дополнительный пример: удаление вариантов по условию атрибута

Если нужно удалять варианты с определённым значением атрибута, например, цветом "красный":

function delete_variations_by_attribute( $parent_id, $attribute_slug, $attribute_value ) {
    $variation_ids = get_variation_ids_by_parent( $parent_id );
    foreach ( $variation_ids as $variation_id ) {
        $terms = wc_get_product_terms( $variation_id, $attribute_slug, ['fields' => 'names'] );
        if ( in_array( $attribute_value, $terms, true ) ) {
            wp_delete_post( $variation_id, true );
        }
    }
}

Вызов:

delete_variations_by_attribute( 123, 'pa_color', 'Красный' );

Это расширяет возможности удаления по бизнес-логике.