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

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

В WooCommerce варианты товаров хранятся как дочерние записи основного товара с типом записи product_variation. Частое решение — удалять их напрямую через SQL-запросы, что часто приводит к:

• нарушению целостности данных (отсутствие связей с атрибутами, метаданными и заказами);
• остаточным данным в таблицах postmeta и woocommerce_order_itemmeta;
• ошибкам в работе сайта и админки, если удалить варианты некорректно.

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

1. Получение ID вариаций товара

Используем класс WC_Product_Variable и метод get_children() для получения ID всех вариантов.

function get_product_variation_ids( $product_id ) {
    $product = wc_get_product( $product_id );
    if ( ! $product || 'variable' !== $product->get_type() ) {
        return [];
    }
    return $product->get_children();
}

2. Удаление вариаций через функцию wp_delete_post

Удаляем каждую вариацию через WP, что автоматически очистит все метаданные и связи.

function delete_product_variations( $product_id ) {
    $variation_ids = get_product_variation_ids( $product_id );
    foreach ( $variation_ids as $variation_id ) {
        wp_delete_post( $variation_id, true ); // true — удаление без возможности восстановления
    }
}

3. Проверка типа продукта и обновление кэша

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

function update_product_type_after_variations_removal( $product_id ) {
    $product = wc_get_product( $product_id );
    if ( $product && 'variable' === $product->get_type() ) {
        // Меняем тип на простой товар
        wp_set_object_terms( $product_id, 'simple', 'product_type' );
        clean_post_cache( $product_id );
    }
}

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

• В админке WooCommerce в карточке товара не отображаются варианты;
• В базе данных отсутствуют записи с post_type = product_variation для данного товара;
• На фронтенде товар отображается как простой, без выбора вариаций;
• В логе ошибок WordPress и WooCommerce отсутствуют сообщения об ошибках, связанных с данным товаром.

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

• Удаление вариантов напрямую через SQL: приводит к «зависшим» метаданным и ошибкам. Решение — использовать wp_delete_post.
• Не обновлен тип товара после удаления вариантов: товар продолжает отображаться вариативным, хотя вариантов нет. Решение — сменить тип товара на простой через таксономию product_type.
• Ошибки кэша: иногда после удаления варианты продолжают отображаться из-за кеширования. Решение — вызвать clean_post_cache() и очистить кеш плагинов.

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

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

Сравнение способов удаления вариантов товара в WooCommerce