Автоматическое заполнение метаданных товаров WooCommerce при импорте CSV

Проблема: пустые или неполные метаданные после импорта товаров CSV в WooCommerce

При массовом импорте товаров в WooCommerce через CSV часто возникает ситуация, когда основная информация импортируется корректно, но дополнительные метаданные (например, артикул, SEO-поля, пользовательские атрибуты) остаются пустыми. Это ведёт к проблемам в отображении товаров, SEO и функционале сайта.

Диагностика проблемы

Чтобы проверить, были ли метаданные заполнены при импорте, выполните следующие шаги:

• Откройте админку WooCommerce и перейдите к редактированию импортированного товара.
• Проверьте поля SKU, пользовательские поля и SEO-метаданные (если используется SEO-плагин).
• Подключитесь к базе данных через phpMyAdmin или другой инструмент и выполните запрос для проверки метаданных продукта (например, SELECT * FROM wp_postmeta WHERE post_id = ID_товара;).

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

Пошаговое решение: добавление автоматического заполнения метаданных при импорте CSV

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

Пример кода для добавления заполнения пользовательского поля _custom_code из колонки CSV custom_code:

add_action('woocommerce_product_import_pre_insert_product_object', function($product, $data) {
    if (!empty($data['custom_code'])) {
        $product->update_meta_data('_custom_code', sanitize_text_field($data['custom_code']));
    }
    return $product;
}, 10, 2);

Обратите внимание, что ключ массива $data должен совпадать с названием колонки CSV (регистрозависимо). Таким способом можно автоматически добавлять любые метаданные.

Пример заполнения артикула (SKU) при отсутствии в CSV

Если в CSV нет колонки sku, но нужно генерировать уникальный артикул, добавьте:

add_action('woocommerce_product_import_pre_insert_product_object', function($product, $data) {
    if (empty($data['sku'])) {
        $unique_sku = 'SKU-' . wp_generate_password(8, false, false);
        $product->set_sku($unique_sku);
    }
    return $product;
}, 10, 2);

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

Чтобы убедиться, что метаданные заполняются корректно:

• Импортируйте тестовый CSV с нужными колонками.
• Откройте импортированный товар в админке WooCommerce и проверьте поля, которые вы добавляли.
• Выполните SQL-запрос к таблице wp_postmeta, чтобы убедиться в наличии новых метаданных.
• Если используете SEO-плагины, проверьте, что SEO-поля также заполнены, если вы их импортировали.

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

• Ключи массива $data не совпадают с названиями колонок CSV. Проверьте точное имя колонки, включая регистр. Встроенный парсер WooCommerce чувствителен к регистру.
• Метаданные не сохраняются. Убедитесь, что вы вызываете update_meta_data() или set_sku() на объекте $product, а не напрямую в базе. Также возвращайте обновлённый объект.
• Поля перезаписываются при повторном импорте. Добавляйте проверки, чтобы не затирать уже заполненные данные без необходимости.
• Импорт слишком медленный. Обработка больших CSV с кастомными хуками может замедлять загрузку. Используйте WP-CLI для импорта или разбивайте CSV на части.

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

• Всегда очищайте данные из CSV: sanitize_text_field() или более строгие фильтры для числовых/даты.
• При большом объёме товаров используйте WP-CLI импорт с кастомной логикой, чтобы избежать таймаутов.
• Не сохраняйте избыточные метаданные, которые не нужны в работе сайта.
• Для SEO-метаданных лучше использовать специализированные плагины и их API для заполнения данных.

Сравнение методов автоматического заполнения метаданных при импорте CSV