Как избежать проблем с отметками продукта в WooCommerce при массовом импорте

Диагностика проблем с отметками продукта при массовом импорте

При импорте большого количества товаров в WooCommerce часто возникают ошибки с атрибутами, категориями и отметками (tags). Проблемы проявляются в виде:

• отсутствия присвоения тегов к товарам;
• дублирования тегов с разным регистром или пробелами;
• конфликтов с уже существующими тегами;
• ошибок импорта CSV из-за неверного формата поля тегов.

Чтобы понять, в чем конкретно проблема, проверьте CSV-файл и логи импорта. WooCommerce по умолчанию не предупреждает о некорректных тегах, поэтому ошибки видны только по отсутствию тегов в админке или на страницах товара.

Типичные признаки неправильного импорта тегов

• Теги не отображаются на странице товара.
• В разделе «Продукты» в колонке тегов пусто.
• В базе данных в таблице wp_terms отсутствуют новые записи тегов.
• Повторяющиеся теги с разным регистром (например, "Красный" и "красный").

Пошаговое решение: правильный импорт тегов в WooCommerce

1. Подготовьте CSV с тегами в правильном формате

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

product_name,product_tags
"Футболка",красный,лето,акция
"Шорты","спорт,лето"

Обратите внимание, что в CSV поля с запятыми берутся в кавычки, но внутри самих тегов запятых быть не должно.

2. Используйте WP All Import с правильной настройкой

WP All Import позволяет задать разделитель для тегов и указать, что это таксономия. При настройке импорта:

• Выберите поле с тегами;
• В настройках таксономий выберите «product_tag»;
• Укажите разделитель — запятая;
• Активируйте опцию «Создавать новые термины, если они не существуют»;
• Убедитесь, что теги не дублируются с разным регистром — для этого можно использовать фильтры PHP (см. пример кода ниже).

3. Очистите дубли и нормализуйте теги после импорта

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

add_action('save_post_product', function($post_id) {
    $terms = wp_get_post_terms($post_id, 'product_tag');
    if (empty($terms) || is_wp_error($terms)) return;
    foreach ($terms as $term) {
        $name_lower = mb_strtolower($term->name);
        if ($name_lower !== $term->name) {
            wp_update_term($term->term_id, 'product_tag', ['name' => $name_lower]);
        }
    }
}, 20, 1);

Этот код при сохранении товара приведет все теги к нижнему регистру и обновит их в базе.

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

• Зайдите в админку WooCommerce в раздел «Продукты» и проверьте столбец «Теги» — они должны отображаться корректно.
• Откройте страницу любого импортированного товара и убедитесь, что теги видны корректно и с ожидаемым регистром.
• В SQL-базе проверьте таблицы wp_terms и wp_term_taxonomy на наличие правильных записей с таксономией product_tag.
• Проверьте, что на сайте нет дублей тегов с разным регистром.

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

• Ошибка: Теги не импортируются — причина в неверном формате CSV или неправильной настройке импортера.
  Решение: Проверьте, что теги в CSV идут через запятую, и в настройках импорта выбрана таксономия product_tag.
• Ошибка: Дублирование тегов с разным регистром.
  Решение: Включите сниппет для нормализации регистра или очистите дубли вручную через phpMyAdmin.
• Ошибка: Теги создаются, но не видны на фронтенде.
  Решение: Проверьте, что шаблон темы корректно выводит теги товара через the_terms() или аналогичные функции.

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

• Перед массовым импортом сделайте резервную копию базы данных.
• Для больших CSV-файлов используйте WP All Import с поддержкой пакетной обработки, чтобы избежать таймаутов.
• Контролируйте права доступа к функциям импорта — запускайте их под администратором.
• Для ускорения вывода тегов на страницах используйте кэширование и оптимизированные запросы.

Сравнение вариантов импорта тегов в WooCommerce