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

Диагностика проблемы: почему стандартный импорт CSV в WooCommerce не всегда подходит

Стандартный импорт товаров через WooCommerce CSV Importer часто не учитывает кастомные поля и метаданные, которые нужны для уникальных характеристик товаров. Это приводит к тому, что часть данных теряется, и после импорта требуется ручное редактирование, что неудобно при больших объемах.

Проверить проблему можно, импортировав CSV с кастомными полями и посмотрев в админке, появились ли эти данные у товаров. Если нет — нужно расширять функционал.

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

1. Подготовка CSV файла

В CSV должны быть стандартные поля WooCommerce (SKU, название, цена) и дополнительные колонки с вашими кастомными полями, например, custom_expiry_date или custom_warranty.

2. Подключение пользовательской функции к импорту

Используем хук woocommerce_product_import_inserted_product_object, который вызывается после создания товара из CSV. В нем добавляем код для записи кастомных полей.

add_action('woocommerce_product_import_inserted_product_object', 'wpex_add_custom_fields_after_import', 10, 2);
function wpex_add_custom_fields_after_import($product, $data) {
    if (!empty($data['custom_expiry_date'])) {
        $product->update_meta_data('custom_expiry_date', sanitize_text_field($data['custom_expiry_date']));
    }
    if (!empty($data['custom_warranty'])) {
        $product->update_meta_data('custom_warranty', sanitize_text_field($data['custom_warranty']));
    }
    $product->save();
}

3. Импорт CSV через стандартный WooCommerce Importer

Загрузите CSV через WooCommerce > Товары > Импорт и запустите процесс. После импорта проверьте, что кастомные поля добавились к товарам.

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

Для проверки зайдите в админку WooCommerce > Товары, откройте любой импортированный товар и убедитесь, что кастомные поля присутствуют в метаданных (можно использовать плагин Advanced Custom Fields или просмотр базы данных через phpMyAdmin). Также можно вывести эти данные в шаблоне:

$expiry_date = get_post_meta($product->get_id(), 'custom_expiry_date', true);
echo 'Срок годности: '.esc_html($expiry_date);

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

• Кастомные поля не добавляются: проверьте, что названия колонок в CSV точно совпадают с ключами в коде, и что хук правильно подключен.
• Поля импортируются, но не отображаются: убедитесь, что выводите метаданные в шаблоне, и используете правильные ключи для get_post_meta.
• Импорт прерывается с ошибками: проверьте формат CSV и кодировку, используйте UTF-8 без BOM.

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

• Используйте sanitize_text_field или другие функции очистки для любых пользовательских данных при импорте.
• При большом объёме товаров импортируйте партиями, чтобы избежать таймаутов и перегрузки сервера.
• Добавляйте логирование ошибок импорта через error_log или собственный лог-файл для отладки.

Сравнение способов добавления кастомных полей при импорте CSV в WooCommerce