WooCommerce: как удалить варианты товаров без пустых значений

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

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

Проверить наличие таких вариантов можно через админ-панель WooCommerce в разделе редактирования товара, вкладка "Вариации" — обратите внимание на варианты, где поля атрибутов пусты или содержат дефолтные значения.

Как выявить пустые значения программно

function has_empty_variation_attributes( $variation_id ) {
    $variation = wc_get_product( $variation_id );
    if ( ! $variation || 'variation' !== $variation->get_type() ) {
        return false;
    }
    $attributes = $variation->get_attributes();
    foreach ( $attributes as $attr_value ) {
        if ( empty( $attr_value ) ) {
            return true;
        }
    }
    return false;
}

Функция возвращает true, если у вариации есть пустые значения атрибутов.

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

Для удаления таких вариантов можно использовать кастомный скрипт, который пройдет по всем вариациям товара и удалит пустые.

Пример скрипта для functions.php или отдельного плагина

function delete_empty_variations_for_product( $product_id ) {
    $product = wc_get_product( $product_id );
    if ( ! $product || 'variable' !== $product->get_type() ) {
        return;
    }
    $variations = $product->get_children();
    foreach ( $variations as $variation_id ) {
        if ( has_empty_variation_attributes( $variation_id ) ) {
            wp_delete_post( $variation_id, true ); // безвозвратно удаляет вариацию
        }
    }
}

// Пример вызова для конкретного товара
// delete_empty_variations_for_product( 123 );

Важно: перед запуском сделайте резервную копию базы данных.

Автоматизация для всех товаров

Если нужно очистить весь каталог, можно запустить цикл по всем переменным товарам:

$args = [
    'post_type' => 'product',
    'posts_per_page' => -1,
    'tax_query' => [
        [
            'taxonomy' => 'product_type',
            'field' => 'slug',
            'terms' => 'variable'
        ]
    ]
];
$query = new WP_Query( $args );
if ( $query->have_posts() ) {
    while ( $query->have_posts() ) {
        $query->the_post();
        delete_empty_variations_for_product( get_the_ID() );
    }
    wp_reset_postdata();
}

Проверка результата

• Откройте карточку товара в админке WooCommerce и убедитесь, что пустые варианты удалены.
• Проверьте фронтенд — вариации с пустыми значениями больше не отображаются.
• Если использовали массовый скрипт, проверьте логи ошибок и корректность работы сайта после удаления.

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

1. Вариации не удаляются

Причина: недостаточно прав у пользователя, под которым запускается скрипт, или неправильное использование wp_delete_post. Убедитесь, что скрипт запускается с правами администратора и что ID вариаций корректные.

2. Удаляются нужные варианты

Проверьте логику функции has_empty_variation_attributes. В некоторых случаях атрибуты могут быть строкой «0» или «none», которые считаются непустыми. При необходимости скорректируйте условие.

3. Перезапись URL вариаций после удаления

Иногда после удаления вариаций нужно сбросить постоянные ссылки (перейдите в Настройки → Постоянные ссылки и нажмите "Сохранить изменения").

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

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

Сравнение способов удаления пустых вариаций