Как создать автоматический импорт CSV в WordPress с поддержкой пользовательских полей

Автоматический импорт данных из CSV файлов — частая задача при работе с WordPress, особенно когда нужно регулярно обновлять контент или загружать товары, записи, пользователей с дополнительными полями. В этой статье рассмотрим, как реализовать такой импорт с поддержкой пользовательских полей (custom fields) на примере кода и популярных плагинов.

Почему важна поддержка пользовательских полей при импорте CSV

WordPress позволяет расширять стандартные записи и посты с помощью метаданных — пользовательских полей. Например, для товаров WooCommerce это цена, артикул, наличие и прочее. Без поддержки таких полей импорт будет неполным и бесполезным.

Также для кастомных типов записей (CPT) и пользователей нужно учитывать дополнительные поля, которые не входят в стандартный набор WordPress.

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

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

Для большинства проектов проще использовать готовые плагины с поддержкой расширенного импорта. Вот несколько проверенных решений:

• WP All Import — мощный и гибкий плагин, который позволяет импортировать CSV и XML файлы с поддержкой кастомных полей, таксономий и сложных структур.
• Really Simple CSV Importer — бесплатный плагин с базовой поддержкой пользовательских полей, подходит для простых задач.
• CSV Importer — бесплатный и простой, но требует доработки для сложных данных.

Для интеграции с WooCommerce оптимально подойдет WP All Import с дополнением для WooCommerce.

Пример автоматического импорта CSV с пользовательскими полями через код на WordPress

Если нужна кастомная логика, можно реализовать импорт самостоятельно через PHP. Ниже пример функции для импорта записей с пользовательскими полями из CSV.

Шаг 1. Подготовьте CSV файл, где первая строка — заголовки столбцов, включая названия пользовательских полей, например:

post_title,post_content,custom_color,custom_size
"Пример товара","Описание товара","Красный","XL"

Шаг 2. Реализуем функцию импорта:

function wptask_import_csv_with_custom_fields($filepath) {
  if (!file_exists($filepath)) {
    return new WP_Error('file_not_found', 'CSV файл не найден');
  }

  if (($handle = fopen($filepath, 'r')) !== false) {
    $header = fgetcsv($handle, 0, ',');
    if (!$header) {
      return new WP_Error('empty_file', 'Файл пустой или неверный формат');
    }

    while (($row = fgetcsv($handle, 0, ',')) !== false) {
      $data = array_combine($header, $row);
      if (!$data) {
        continue; // Пропускаем некорректные строки
      }

      // Создаем запись
      $post_id = wp_insert_post(array(
        'post_title' => sanitize_text_field($data['post_title']),
        'post_content' => sanitize_textarea_field($data['post_content']),
        'post_status' => 'publish',
        'post_type' => 'post'
      ));

      if (is_wp_error($post_id)) {
        continue;
      }

      // Добавляем пользовательские поля
      foreach ($data as $key => $value) {
        if (in_array($key, ['post_title', 'post_content'])) {
          continue; // Уже добавлено
        }
        update_post_meta($post_id, sanitize_key($key), sanitize_text_field($value));
      }
    }
    fclose($handle);
  }
  return true;
}

Для запуска функции достаточно передать путь к CSV файлу на сервере:

wptask_import_csv_with_custom_fields(ABSPATH . 'wp-content/uploads/import.csv');

Такой подход дает полную гибкость: вы сами контролируете процесс импорта, фильтрацию и форматирование данных.

Автоматизация процесса: запуск импорта по расписанию

Чтобы не запускать импорт вручную, можно настроить CRON-задачу через WP-Cron. Для этого добавим функцию, которая будет запускать импорт регулярно.

add_action('wptask_cron_import_csv', 'wptask_run_import_csv_job');

function wptask_run_import_csv_job() {
  $filepath = ABSPATH . 'wp-content/uploads/import.csv';
  wptask_import_csv_with_custom_fields($filepath);
}

// Регистрация задания при активации плагина или темы
if (!wp_next_scheduled('wptask_cron_import_csv')) {
  wp_schedule_event(time(), 'hourly', 'wptask_cron_import_csv');
}

Так импорт будет запускаться каждый час. При необходимости частоту можно изменить.

Как интегрировать импорт с пользовательскими плагинами WPShop

Если вы используете на сайте плагины WPShop, например, WPRemark для отзывов или WPGPT для генерации контента, вы можете расширить функцию импорта, чтобы автоматически создавать отзывы или генерировать описания при импорте новых записей.

Например, после создания поста запустить генерацию описания через WPGPT API или добавить связанные отзывы через WPRemark.

Советы по безопасности и производительности при импорте CSV

Импорт больших CSV может нагрузить сервер и вызвать таймауты. Рекомендуется:

• Разбивать файл на части и импортировать порционно.
• Использовать транзакции базы данных, если доступно, чтобы избежать частичного импорта.
• Валидацию и очистку данных обязательно делать, чтобы избежать XSS или SQL-инъекций.
• Проверять права пользователя, если запускать импорт из админки.

Также полезно логировать процесс, чтобы отслеживать ошибки.

Итоги

Создание автоматического импорта CSV с поддержкой пользовательских полей — задача вполне решаемая как с помощью готовых плагинов, так и самостоятельно через код. В зависимости от требований к гибкости и объему данных выбирайте подходящий инструмент.

Использование WP All Import подойдет для сложных проектов, а собственный код — для кастомных сценариев. Автоматизация через WP-Cron позволит не беспокоиться о запуске вручную.

Используйте возможности WordPress по максимуму, чтобы облегчить работу с большим объемом данных и поддерживать контент сайта всегда актуальным.