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

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

Почему стоит автоматизировать импорт CSV в WordPress

Ручной импорт через стандартные инструменты WordPress или сторонние плагины часто требует много времени и может приводить к ошибкам при обработке больших объёмов данных. Автоматизация импорта позволяет:

• Обрабатывать большие файлы без участия пользователя;
• Сохранять структуру и связи данных;
• Регулярно обновлять контент по расписанию, например, с помощью wp-cron;
• Гибко настраивать логику импорта под свои нужды.

Для примера создадим функцию, которая будет импортировать записи из CSV в кастомный тип записей, но этот подход легко адаптировать и для стандартных постов, и для таксономий.

Подготовка CSV-файла и структура данных

Прежде чем писать код, убедитесь, что CSV-файл соответствует требованиям:

• Первая строка — заголовки столбцов, например: title, content, category, date;
• Данные корректно экранированы и не содержат лишних символов;
• Формат даты и времени соответствует стандарту, который вы сможете обработать в коде.

Пример строки CSV:

title,content,category,date
"Пример заголовка","Текст записи","Новости","2024-05-20 10:00:00"

Пример функции для импорта CSV в кастомный тип записей

Ниже представлен пример функции, которая открывает CSV-файл, парсит его, и импортирует записи в тип post_type = 'wpteam_article'. Обратите внимание, что функция начинается с префикса wpteam_ — это хорошая практика для избегания конфликтов имён.

function wpteam_import_csv_to_custom_post_type($csv_file_path) {
    if (!file_exists($csv_file_path) || !is_readable($csv_file_path)) {
        return new WP_Error('file_error', 'CSV файл не найден или недоступен для чтения');
    }

    $header = null;
    $data = array();

    if (($handle = fopen($csv_file_path, 'r')) !== false) {
        while (($row = fgetcsv($handle, 1000, ',')) !== false) {
            if (!$header) {
                $header = $row;
            } else {
                $data[] = array_combine($header, $row);
            }
        }
        fclose($handle);
    }

    foreach ($data as $item) {
        // Подготовка данных
        $post_data = array(
            'post_title'    => sanitize_text_field($item['title']),
            'post_content'  => wp_kses_post($item['content']),
            'post_status'   => 'publish',
            'post_type'     => 'wpteam_article',
            'post_date'     => sanitize_text_field($item['date']),
        );

        // Вставляем запись и получаем ID
        $post_id = wp_insert_post($post_data);

        if (is_wp_error($post_id)) {
            error_log('Ошибка при вставке записи: ' . $post_id->get_error_message());
            continue;
        }

        // Пример добавления таксономии
        if (!empty($item['category'])) {
            wp_set_object_terms($post_id, sanitize_text_field($item['category']), 'category');
        }
    }

    return true;
}

Автоматизация импорта с помощью wp-cron

Чтобы импорт запускался автоматически, например, каждый час, можно использовать встроенный планировщик задач WordPress — wp-cron. Добавим событие и обработчик:

// Регистрируем событие при активации темы или плагина
function wpteam_activation() {
    if (! wp_next_scheduled('wpteam_hourly_import')) {
        wp_schedule_event(time(), 'hourly', 'wpteam_hourly_import');
    }
}
register_activation_hook(__FILE__, 'wpteam_activation');

// Отписка при деактивации
function wpteam_deactivation() {
    wp_clear_scheduled_hook('wpteam_hourly_import');
}
register_deactivation_hook(__FILE__, 'wpteam_deactivation');

// Хук для обработки импорта
add_action('wpteam_hourly_import', 'wpteam_run_import');
function wpteam_run_import() {
    $csv_path = WP_CONTENT_DIR . '/uploads/wpteam_import.csv';
    wpteam_import_csv_to_custom_post_type($csv_path);
}

Рекомендации по плагинам для расширенного импорта CSV

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

• WP Importer — мощный плагин с поддержкой кастомных полей и таксономий;
• Clearfy Pro — оптимизация и расширенные возможности для импорта и работы с данными;
• WPRemark — для создания отзывов и импорта контента с отзывами из CSV.

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

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

При импорте данных важно обеспечить валидацию и санитизацию входящих данных. В примере выше мы использовали sanitize_text_field и wp_kses_post, чтобы избежать внедрения вредоносного кода.

Также рекомендуем логировать ошибки и предупреждения в отдельный файл или в системный журнал, чтобы своевременно реагировать на проблемы.

Кроме того, доступ к CSV-файлам и функциям импорта должен быть ограничен, например, только для администраторов или через защищённый REST API.

Заключение

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

Для удобства и расширенных функций можно рассмотреть плагин WP Importer из каталога WPSHOP — он хорошо интегрируется с другими плагинами и темами.