WooCommerce: автоматическое изменение атрибутов и вариантов товаров через код

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

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

Как понять, что автоматизация нужна именно вам

• Изменения атрибутов происходят регулярно и массово.
• Варианты товаров создаются или обновляются на основе внешних данных.
• Необходимо синхронизировать данные между разными площадками.
• Ручное управление вариантами занимает слишком много времени.

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

1. Получение объекта товара и подготовка к изменению

Используйте класс WC_Product_Variable для работы с товаром с вариациями:

$product_id = 123; // ID вашего товара с вариантами
$product = wc_get_product($product_id);

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

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

Для обновления атрибутов используйте массив WC_Product_Attribute. Пример добавления нового атрибута «Цвет» с терминами:

$attributes = [];

$attribute = new WC_Product_Attribute();
$attribute->set_id(0); // 0 для пользовательского атрибута
$attribute->set_name('pa_color'); // slug атрибута
$attribute->set_options(['red', 'blue']); // слаги терминов
$attribute->set_position(0);
$attribute->set_visible(true);
$attribute->set_variation(true);

$attributes[] = $attribute;

$product->set_attributes($attributes);
$product->save();

3. Обновление вариантов товара

Для каждого варианта измените атрибуты через объект WC_Product_Variation. Пример изменения атрибута варианта:

$variation_id = 456; // ID варианта
$variation = new WC_Product_Variation($variation_id);

$attributes = $variation->get_attributes();
$attributes['pa_color'] = 'red'; // новый цвет

$variation->set_attributes($attributes);
$variation->save();

4. Автоматизация через хук при сохранении товара

Чтобы автоматически менять варианты при сохранении товара, используйте хук save_post_product:

add_action('save_post_product', 'auto_update_variations_on_save', 20, 3);
function auto_update_variations_on_save($post_id, $post, $update) {
    $product = wc_get_product($post_id);
    if (!$product || $product->get_type() !== 'variable') return;

    // пример: установить всем вариантам цвет «синий»
    $variations = $product->get_children();
    foreach ($variations as $variation_id) {
        $variation = new WC_Product_Variation($variation_id);
        $attrs = $variation->get_attributes();
        $attrs['pa_color'] = 'blue';
        $variation->set_attributes($attrs);
        $variation->save();
    }
}

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

• Откройте карточку товара в админке и убедитесь, что атрибуты обновились.
• Проверьте варианты товара — их атрибуты должны соответствовать изменениям.
• На фронтенде убедитесь, что правильные варианты доступны для выбора и отображается корректная цена (если она зависит от варианта).
• Для проверки можно добавить временный вывод в лог: error_log(print_r($attributes, true));

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

• Атрибут не появляется в списке вариаций: убедитесь, что set_variation(true) выставлен, и что атрибут зарегистрирован в WooCommerce (pa_ префикс для глобальных атрибутов).
• Вариант не обновляется: проверьте, что используете правильный объект WC_Product_Variation и вызываете save() после изменений.
• После обновления товара атрибуты сбрасываются: не перезаписывайте атрибуты без необходимости, можно сначала получить текущие и дополнять их.
• Ошибка доступа при сохранении: убедитесь, что код запускается в нужном контексте с правами администратора.

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

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

Сравнение подходов: плагин vs код vs компромисс