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

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

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

Типичные проблемы при импорте атрибутов и тегов

• Несоответствие формата атрибутов между CSV и WooCommerce — атрибуты не применяются или создаются дубли;
• Теги товара не распознаются или не добавляются корректно;
• Отсутствие возможности динамически менять значения в процессе импорта;
• Проблемы с производительностью при большом объёме импортируемых данных.

Пошаговое решение: автоматическое изменение атрибутов и тегов при импорте CSV

Для решения задачи используем хук woocommerce_product_import_inserted_product_object, который срабатывает после создания или обновления продукта при импорте. Через этот хук можно программно изменить атрибуты и теги на лету.

1. Подключение функции к хуку

add_action('woocommerce_product_import_inserted_product_object', 'custom_change_attributes_and_tags', 10, 2);

2. Реализация функции изменения атрибутов и тегов

function custom_change_attributes_and_tags( $product, $data ) {
    // Пример: если в CSV есть категория 'Old Category', меняем атрибут 'Цвет' на 'Красный'
    if ( in_array('Old Category', $product->get_category_ids()) ) {
        // Установка атрибута 'pa_color' (предполагается, что атрибут создан в WooCommerce)
        $attributes = $product->get_attributes();
        $color_attr = wc_get_attribute_taxonomy_labels()[ 'pa_color' ] ?? false;

        if ( $color_attr ) {
            // Устанавливаем значение атрибута 'pa_color'
            $product->set_attribute('pa_color', 'red');
        }

        // Добавление тега 'акционный'
        wp_set_post_terms( $product->get_id(), 'акционный', 'product_tag', true );

        $product->save();
    }
}

В этом примере при обнаружении категории 'Old Category' у товара атрибут pa_color меняется на 'red', а к тегам добавляется 'акционный'.

3. Как проверить, что изменения сработали

• После импорта зайдите в редактор товара в админке WooCommerce и проверьте, что атрибут Цвет установлен в «Красный»;
• Проверьте, что в блоке тегов товара появился тег «акционный»;
• Если импортируете много товаров, можно вывести в консоль браузера или лог файл ID товаров и их атрибуты для выборочной проверки.

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

Для проверки результата можно использовать простой скрипт в консоли WordPress или WP-CLI:

// Получить атрибуты и теги по ID товара
$product = wc_get_product(123);
var_dump($product->get_attributes());
var_dump(wp_get_post_terms(123, 'product_tag', array('fields' => 'names')));

Если атрибуты и теги соответствуют заданным условиям, значит код работает корректно.

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

• Атрибуты не меняются: проверьте, что атрибуты созданы в WooCommerce как таксономии pa_* и правильно указаны в коде;
• Теги не добавляются: убедитесь, что используете правильный слуг тега и таксономию product_tag в функции wp_set_post_terms;
• Ошибка сохранения продукта: не забывайте вызывать $product->save() после изменений;
• Хук не срабатывает: проверьте, что импорт выполняется через штатный импортёр WooCommerce, а не сторонними плагинами, которые могут использовать свои хуки.

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

• Не выполняйте тяжелые операции в хуках импорта, чтобы не замедлять процесс;
• Для массового импорта лучше предварительно подготовить CSV с нужными значениями, а код использовать только для редких правок;
• Используйте транзакции или временное кэширование, если нужно изменять много связанных данных;
• Проверяйте входные данные на валидность, чтобы избежать ошибок и «сломанных» товаров после импорта.

Сравнение способов изменения атрибутов и тегов при импорте

Метод	Плюсы	Минусы
Использование хука woocommerce_product_import_inserted_product_object	Гибкая кастомизация, работает автоматически при импорте	Требует навыков программирования, зависит от стандартного импортера
Предварительная подготовка CSV с нужными значениями	Простота, не требует кода	Меньшая гибкость, сложнее массово менять уже импортированные товары
Использование плагинов (например, WP All Import с кастомными функциями)	Широкие возможности, поддержка сложных условий	Платные решения, возможны конфликты с другими плагинами