Как изменить атрибуты вариативных товаров в WooCommerce через код

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

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

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

• Откройте товар в админке WooCommerce, вкладка Атрибуты.
• Проверьте, что атрибуты связаны с вариациями (галочка «Использовать для вариаций» стоит).
• В разделе Вариации есть варианты, соответствующие атрибутам.
• На фронтенде товара варианты переключаются и правильно отображаются.

Пошаговое решение: как программно изменить атрибуты вариативного товара

1. Получение объекта товара и его атрибутов

$product = wc_get_product( $product_id );
if ( ! $product || 'variable' !== $product->get_type() ) {
    return; // не вариативный товар
}
$attributes = $product->get_attributes();

2. Изменение значений атрибутов

Допустим, нужно заменить значение атрибута "Цвет" (pa_color) у товара. Атрибуты бывают глобальными (с таксономией) и локальными (без). Ниже пример для глобального атрибута:

if ( isset( $attributes['pa_color'] ) ) {
    $attribute = $attributes['pa_color'];
    $new_terms = ['red', 'green', 'blue']; // слаги новых терминов
    $taxonomy = $attribute->get_name();
    wp_set_object_terms( $product_id, $new_terms, $taxonomy );

    // Обновляем объект атрибута
    $attribute->set_options( $new_terms );
    $attributes['pa_color'] = $attribute;
    $product->set_attributes( $attributes );
    $product->save();
}

3. Создание или обновление вариаций под новые атрибуты

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

// Удаляем старые вариации
$variations = $product->get_children();
foreach ( $variations as $variation_id ) {
    wp_delete_post( $variation_id, true );
}

// Создаем вариации с новыми атрибутами
foreach ( $new_terms as $term_slug ) {
    $variation_post = array(
        'post_title'  => $product->get_name() . ' - ' . $term_slug,
        'post_name'   => 'product-' . $product_id . '-variation-' . $term_slug,
        'post_status' => 'publish',
        'post_parent' => $product_id,
        'post_type'   => 'product_variation',
    );
    $variation_id = wp_insert_post( $variation_post );

    // Задаем атрибуты вариации
    $variation = new WC_Product_Variation( $variation_id );
    $variation_attributes = [
        'pa_color' => $term_slug,
    ];
    $variation->set_attributes( $variation_attributes );
    $variation->set_regular_price( '1000' ); // пример цены
    $variation->save();
}

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

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

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

• Атрибуты не отображаются на сайте — проверьте, что у атрибута стоит флаг «Использовать для вариаций» в объекте WC_Product_Attribute.
• Вариации не создаются — убедитесь, что вы вызываете wp_insert_post с правильными параметрами и после этого вызываете методы set_attributes и save у WC_Product_Variation.
• Ошибки с таксономиями атрибутов — атрибуты с префиксом pa_ должны существовать как таксономии в WooCommerce. Для новых атрибутов создайте их через админку или программно перед использованием.
• Вариации не показывают цену — установите цену через метод set_regular_price вариации, иначе вариация считается неактивной.

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

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

Сравнение вариантов изменения атрибутов вариативных товаров