WooCommerce: как автоматически устанавливать и удалять типовые атрибуты товаров с помощью кода

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

В магазинах на WooCommerce часто возникают задачи, когда необходимо массово добавлять или удалять стандартные атрибуты у большого количества товаров. Например, нужно автоматически назначить атрибут "Материал" при импорте товаров или удалить устаревший атрибут "Сезон" из всех товаров. Ручное выполнение этих операций в админке занимает много времени и подвержено ошибкам. Автоматизация с помощью PHP кода позволяет ускорить процесс и исключить человеческий фактор.

Пошаговое решение: как программно управлять атрибутами товаров WooCommerce

1. Добавление типового атрибута к товару

Используем функцию wp_set_object_terms() для назначения термина атрибута товару. Предположим, атрибут "Материал" зарегистрирован как таксономия pa_material, а термин "Хлопок" существует.

function add_material_attribute_to_product($product_id, $term_slug) {
    $taxonomy = 'pa_material';
    if (!term_exists($term_slug, $taxonomy)) {
        wp_insert_term($term_slug, $taxonomy);
    }
    wp_set_object_terms($product_id, $term_slug, $taxonomy, true); // true – добавить, не заменять
    // Обновляем мета с флагом атрибутов
    $product = wc_get_product($product_id);
    $attributes = $product->get_attributes();
    if (!isset($attributes[$taxonomy])) {
        $attributes[$taxonomy] = new WC_Product_Attribute();
        $attributes[$taxonomy]->set_id(wc_attribute_taxonomy_id_by_name('material'));
        $attributes[$taxonomy]->set_name($taxonomy);
        $attributes[$taxonomy]->set_options(array($term_slug));
        $attributes[$taxonomy]->set_visible(true);
        $attributes[$taxonomy]->set_variation(false);
        $product->set_attributes($attributes);
        $product->save();
    }
}

2. Удаление атрибута из товара

Чтобы удалить атрибут, нужно удалить термины таксономии, а затем обновить атрибуты товара.

function remove_attribute_from_product($product_id, $taxonomy) {
    wp_set_object_terms($product_id, array(), $taxonomy, false); // очистить термины
    $product = wc_get_product($product_id);
    $attributes = $product->get_attributes();
    if (isset($attributes[$taxonomy])) {
        unset($attributes[$taxonomy]);
        $product->set_attributes($attributes);
        $product->save();
    }
}

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

Через WP_Query получим все товары и применим функции.

$args = [
    'post_type' => 'product',
    'posts_per_page' => -1
];
$products = get_posts($args);
foreach ($products as $post) {
    $product_id = $post->ID;
    add_material_attribute_to_product($product_id, 'hlopok');
    // Или для удаления
    // remove_attribute_from_product($product_id, 'pa_sezon');
}

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

Для проверки:

• Откройте любой товар, к которому применили атрибут, в админке WooCommerce.
• Проверьте наличие термина атрибута на вкладке "Атрибуты".
• На фронтенде товара убедитесь, что атрибут отображается в блоке с характеристиками.
• Для удаления — убедитесь, что атрибут отсутствует в списке атрибутов товара и на странице товара.

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

• Неверное имя таксономии: для атрибутов WooCommerce таксономия всегда начинается с pa_. Проверьте точное имя в разделе "Атрибуты" админки.
• Отсутствие термина в таксономии: перед добавлением термина убедитесь, что он существует или создайте с помощью wp_insert_term().
• Не обновляются атрибуты товара: после изменения терминов обязательно обновляйте атрибуты через объект WC_Product и вызывайте save().
• Кэширование: при использовании кэш-плагинов очистите кэш после изменений.

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

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

Сравнение способов управления атрибутами: код vs плагины