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

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

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

Пошаговое решение: удаление вариаций с помощью WP-CLI и PHP-кода

1. Удаление вариаций через WP-CLI

WP-CLI позволяет быстро удалять товары и вариации из командной строки. Для удаления вариаций используйте фильтр по типу поста product_variation.

wp post delete $(wp post list --post_type=product_variation --format=ids) --force

Эта команда удалит все вариации товаров без возможности восстановления из корзины (за счет --force).

2. Программное удаление вариаций через PHP-функцию

Если нужен более тонкий контроль (например, удалять вариации только у определённых товаров или по условию), используйте следующий код в файле functions.php или в отдельном плагине:

function remove_product_variations_by_parent_ids( array $parent_ids ) {
    foreach ( $parent_ids as $parent_id ) {
        $args = [
            'post_type'      => 'product_variation',
            'post_status'    => ['publish', 'private'],
            'numberposts'    => -1,
            'post_parent'    => $parent_id,
            'fields'         => 'ids',
        ];
        $variation_ids = get_posts( $args );

        foreach ( $variation_ids as $variation_id ) {
            wp_delete_post( $variation_id, true ); // true — удаляет насовсем
        }
    }
}

// Пример вызова функции:
remove_product_variations_by_parent_ids([123, 456]); // Замените 123, 456 на ID товаров

Этот код удалит все вариации для товаров с указанными ID.

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

• Перейдите в админку WooCommerce → Товары и откройте нужный товар. Вкладка вариаций должна быть пустой.
• В базе данных в таблице wp_posts не должно остаться записей с post_type = 'product_variation' для удалённых товаров.
• Если вы использовали WP-CLI, команда wp post list --post_type=product_variation должна возвращать пустой список или только вариации других товаров.

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

• Вариации не удаляются полностью: Возможно, вы не передали параметр $force = true в wp_delete_post(). Без него посты попадут в корзину, но не удалятся насовсем. Добавьте true вторым аргументом.
• Удаляются не те вариации: Проверьте параметр post_parent в запросе. Нужно указывать ID именно родительских товаров, чтобы не удалить чужие вариации.
• Ошибки при выполнении WP-CLI команды: Убедитесь, что у вас есть права на удаление постов и что WP-CLI корректно подключен к вашему сайту.

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

• Перед массовым удалением создайте резервную копию базы данных, чтобы избежать потери данных в случае ошибки.
• Если вариаций слишком много (тысячи), разбивайте удаление на партии, чтобы избежать таймаутов и перегрузки сервера.
• Используйте WP-CLI для быстрого массового удаления — это эффективнее и безопаснее, чем запускать тяжелый PHP-скрипт через веб-интерфейс.
• После удаления вариаций очистите кеш сайта и кеш WooCommerce, если используете плагины кеширования.

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