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

Импорт данных из CSV-файлов — частая задача при работе с WordPress, будь то перенос товаров, пользователей или записей блога. В этой статье подробно разберём, как настроить автоматический импорт CSV в WordPress с помощью собственного кода и популярных плагинов. Это позволит вам регулярно обновлять контент без ручного вмешательства.

Почему нужен автоматический импорт CSV в WordPress

Ручной импорт через админку подходит при разовых загрузках, но если данные обновляются часто, этот процесс становится рутинным и подвержен ошибкам. Автоматический импорт CSV:

• Экономит время и силы за счёт автоматизации;
• Позволяет интегрировать данные из внешних систем;
• Обеспечивает актуальность контента на сайте;
• Минимизирует человеческий фактор и ошибки в данных.

Например, интернет-магазин может ежедневно обновлять остатки и цены товаров из CSV, экспортируемого из учетной системы.

Популярные плагины для импорта CSV в WordPress

Среди плагинов выделяются:

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

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

Настройка автоматического импорта через WP All Import

После установки и активации:

1. Создайте новую задачу импорта и загрузите CSV или укажите URL файла.
2. Настройте сопоставление колонок CSV с полями WordPress (заголовок, содержимое, кастомные поля и т.д.).
3. В разделе Scheduling включите автоматический запуск по cron, указав нужный интервал.
4. Сохраните и запустите импорт.

Плагин автоматически обработает файл и обновит записи согласно настройкам.

Реализация автоматического импорта CSV с помощью собственного кода

Если нужен более точечный контроль или вы хотите обойтись без плагинов, можно написать собственный скрипт импорта, запускаемый по cron.

Пример функции импорта CSV в WordPress

Ниже пример функции wpma_import_csv_to_posts(), которая читает CSV и создаёт записи типа ‘post’ с пользовательскими полями.

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

    $handle = fopen($csv_file_path, 'r');
    if (!$handle) {
        return new WP_Error('file_open_error', 'Не удалось открыть CSV файл');
    }

    $header = fgetcsv($handle); // Читаем заголовок
    while (($row = fgetcsv($handle)) !== false) {
        $data = array_combine($header, $row);

        // Проверяем обязательные поля
        if (empty($data['post_title']) || empty($data['post_content'])) {
            continue; // пропускаем некорректные записи
        }

        // Формируем массив записи
        $post_data = array(
            'post_title' => sanitize_text_field($data['post_title']),
            'post_content' => wp_kses_post($data['post_content']),
            'post_status' => 'publish',
            'post_type' => 'post'
        );

        // Вставляем запись
        $post_id = wp_insert_post($post_data);
        if (is_wp_error($post_id)) {
            continue; // ошибка при вставке
        }

        // Добавляем кастомные поля, если есть
        if (!empty($data['custom_field'])) {
            update_post_meta($post_id, 'custom_field', sanitize_text_field($data['custom_field']));
        }
    }
    fclose($handle);
    return true;
}

Эту функцию можно вызывать из задачи cron, передавая путь к CSV-файлу. Важно обрабатывать ошибки и валидировать данные.

Настройка cron для автоматического запуска импорта

Добавьте в functions.php следующий код для регистрации cron-задания:

function wpma_register_import_cron() {
    if (!wp_next_scheduled('wpma_import_csv_event')) {
        wp_schedule_event(time(), 'hourly', 'wpma_import_csv_event');
    }
}
add_action('wp', 'wpma_register_import_cron');

add_action('wpma_import_csv_event', 'wpma_run_import');
function wpma_run_import() {
    $csv_path = ABSPATH . 'wp-content/uploads/import.csv';
    wpma_import_csv_to_posts($csv_path);
}

Этот код настроит запуск функции импорта ежечасно. Вы можете изменить интервал на daily или custom.

Обработка ошибок и безопасности при импорте CSV

При работе с импортом важно предусмотреть:

• Проверку и валидацию данных — используйте sanitize_text_field, wp_kses_post или аналогичные функции для очистки входящих данных.
• Обработку ошибок файловой системы — проверяйте существование и доступность файла.
• Ограничение доступа — храните CSV в защищённой папке и контролируйте права доступа.
• Логирование — записывайте успешные и неудачные попытки импорта для отладки.

Пример интеграции с плагином Clearfy Pro для оптимизации импорта

Плагин Clearfy Pro позволяет оптимизировать работу сайта и может помочь с настройками cron и кеширования, чтобы импорт проходил быстрее и без конфликтов. Например, временно отключать кеш или оптимизировать работу PHP во время выполнения импорта.

Итоговые рекомендации по автоматическому импорту CSV в WordPress

Автоматический импорт CSV — мощный инструмент, который поможет поддерживать актуальность данных на сайте. Для простых задач подойдут плагины, для более сложных лучше писать собственные решения с учётом специфики проекта.

В любом случае не забывайте про безопасность, обработку ошибок и тестирование на тестовом сайте перед запуском на продакшене.