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

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

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

Как проверить текущие атрибуты связанных товаров

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

• Откройте административную панель WordPress.
• Перейдите в Товары > Все товары.
• Выберите товар, у которого есть связанные товары (upsells, cross-sells или grouped products).
• В разделе Атрибуты проверьте список атрибутов, назначенных этому товару.
• Для связанных товаров посмотрите их карточки и проверьте назначенные атрибуты.

Если вы хотите получить список атрибутов для связанных товаров программно, используйте следующий код в functions.php или отдельном плагине:

function get_related_products_attributes( $product_id ) {
    $product = wc_get_product( $product_id );
    if ( ! $product ) {
        return [];
    }

    $related_ids = array_merge(
        $product->get_upsell_ids(),
        $product->get_cross_sell_ids(),
        $product->get_grouped_products()
    );

    $attributes = [];
    foreach ( $related_ids as $id ) {
        $related_product = wc_get_product( $id );
        if ( $related_product ) {
            $attributes[ $id ] = $related_product->get_attributes();
        }
    }

    return $attributes;
}

Вызовите эту функцию с ID интересующего товара и проанализируйте вывод.

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

Если нужно массово удалить определённый атрибут у связанных товаров, выполните следующие шаги:

1. Получите ID товара с нужными связанными товарами.
2. Получите массив ID связанных товаров (upsells, cross-sells, grouped).
3. Для каждого связанного товара загрузите объект WC_Product.
4. Удалите нужный атрибут из массива атрибутов.
5. Сохраните обновлённый объект товара.

Пример кода для удаления атрибута с таксономическим именем pa_color у всех связанных товаров:

function remove_attribute_from_related_products( $product_id, $attribute_name ) {
    $product = wc_get_product( $product_id );
    if ( ! $product ) return;

    $related_ids = array_merge(
        $product->get_upsell_ids(),
        $product->get_cross_sell_ids(),
        $product->get_grouped_products()
    );

    foreach ( $related_ids as $id ) {
        $related_product = wc_get_product( $id );
        if ( ! $related_product ) continue;

        $attributes = $related_product->get_attributes();

        if ( isset( $attributes[ $attribute_name ] ) ) {
            unset( $attributes[ $attribute_name ] );

            // Обновляем атрибуты
            $related_product->set_attributes( $attributes );
            $related_product->save();
        }
    }
}

// Пример вызова:
remove_attribute_from_related_products( 123, 'pa_color' );

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

Для изменения значения атрибута (например, исправить опечатку в термине) нужно получить объект атрибута, изменить его значения и сохранить товар. Для таксономических атрибутов это сложнее, т.к. термины хранятся в таксономиях.

Пример замены термина атрибута pa_color с red на scarlet у связанных товаров:

function rename_attribute_term_in_related_products( $product_id, $attribute_name, $old_term_slug, $new_term_slug ) {
    $product = wc_get_product( $product_id );
    if ( ! $product ) return;

    $related_ids = array_merge(
        $product->get_upsell_ids(),
        $product->get_cross_sell_ids(),
        $product->get_grouped_products()
    );

    foreach ( $related_ids as $id ) {
        $related_product = wc_get_product( $id );
        if ( ! $related_product ) continue;

        $attributes = $related_product->get_attributes();

        if ( ! isset( $attributes[ $attribute_name ] ) ) continue;

        $attr = $attributes[ $attribute_name ];

        if ( $attr->is_taxonomy() ) {
            $terms = wp_get_post_terms( $id, $attribute_name, [ 'fields' => 'slugs' ] );

            if ( in_array( $old_term_slug, $terms, true ) ) {
                // Заменяем термин
                $new_terms = array_map( function( $term ) use ( $old_term_slug, $new_term_slug ) {
                    return $term === $old_term_slug ? $new_term_slug : $term;
                }, $terms );

                wp_set_post_terms( $id, $new_terms, $attribute_name );
            }
        }
    }
}

// Пример вызова:
rename_attribute_term_in_related_products( 123, 'pa_color', 'red', 'scarlet' );

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

• В админке WooCommerce откройте карточки связанных товаров и убедитесь, что атрибуты удалены или изменены.
• Для выборочного теста используйте функцию get_related_products_attributes из раздела диагностики.
• Если у вас есть кэш, очистите его — иначе изменения не отобразятся сразу.
• Используйте SQL-запросы для проверки таблиц wp_postmeta и wp_term_relationships, чтобы убедиться, что данные обновились.

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

• Ошибка: Изменения не применяются, атрибуты остаются.
• Причина: Кэширование объекта товара или кэш плагинов.
• Решение: Очистите кэш, используйте wc_delete_product_transients( $product_id ) после сохранения.

• Ошибка: Попытка удалить атрибут у товара без проверки существования.
• Причина: Ошибки PHP из-за обращения к несуществующим индексам массива.
• Решение: Всегда проверяйте наличие атрибута через isset().

• Ошибка: Изменения атрибутов не видны на фронтенде.
• Причина: Кэш браузера, плагинов или CDN.
• Решение: Очистите кэш и проверьте в режиме инкогнито.

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

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

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