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

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

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

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

• Сэкономить время и силы на массовом добавлении пользователей;
• Автоматизировать процессы миграции данных;
• Обеспечить единообразие и правильное заполнение профилей;
• Интегрировать WordPress с внешними системами.

Этот процесс особенно актуален для образовательных сайтов, intranet-порталов и сайтов с подписками.

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

Существует несколько плагинов, которые упрощают импорт пользователей из CSV:

• Import Users from CSV with Meta — позволяет импортировать не только стандартные поля, но и пользовательские метаданные.
• User Meta — расширенный плагин для управления пользовательскими полями с поддержкой импорта.
• WP All Import Pro + Add-On User Import — мощный и гибкий инструмент для импорта любых данных, в том числе пользователей.

Для автоматизации процесса импорта при регулярном обновлении CSV лучше использовать WP All Import с настройкой cron-задач. Подробнее о плагинах с wpshop.ru.

Как создать автоматический импорт пользователей с помощью PHP-кода

Если вы хотите сделать импорт из CSV по своему сценарию и без сторонних плагинов, можно воспользоваться следующим примером кода. Он демонстрирует базовый импорт с обязательными полями — логином, email и паролем.

function wpma_ru_import_users_from_csv($filepath) {
    if (!file_exists($filepath)) {
        return new WP_Error('file_not_found', 'CSV файл не найден');
    }
    $handle = fopen($filepath, '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['user_login']) || empty($data['user_email'])) {
            continue; // пропускаем неполные записи
        }
        if (username_exists($data['user_login']) || email_exists($data['user_email'])) {
            continue; // пользователь уже существует
        }
        $userdata = array(
            'user_login' => sanitize_user($data['user_login']),
            'user_email' => sanitize_email($data['user_email']),
            'user_pass'  => !empty($data['user_pass']) ? $data['user_pass'] : wp_generate_password(),
            'first_name' => sanitize_text_field($data['first_name'] ?? ''),
            'last_name'  => sanitize_text_field($data['last_name'] ?? ''),
            'role'       => sanitize_text_field($data['role'] ?? 'subscriber'),
        );
        wp_insert_user($userdata);
    }
    fclose($handle);
    return true;
}

Для запуска импорта достаточно вызвать функцию и передать путь к CSV файлу. Важно, чтобы CSV имел заголовки: user_login, user_email, user_pass (опционально), first_name, last_name, role.

Расширение функционала — добавление пользовательских метаданных

Если нужно импортировать дополнительные поля, например, телефон или адрес, можно расширить функцию, добавив после wp_insert_user вызов update_user_meta:

$user_id = wp_insert_user($userdata);
if (!is_wp_error($user_id)) {
    if (!empty($data['phone'])) {
        update_user_meta($user_id, 'phone', sanitize_text_field($data['phone']));
    }
    // Добавляйте другие мета по аналогии
}

Как автоматизировать запуск импорта по расписанию

Для автоматического запуска импорта, например, при загрузке нового файла на сервер, удобно использовать WP-Cron. Добавим хук, который будет запускать импорт раз в сутки:

add_action('wpma_ru_daily_user_import', 'wpma_ru_run_daily_import');
function wpma_ru_run_daily_import() {
    $filepath = WP_CONTENT_DIR . '/uploads/users-import.csv';
    wpma_ru_import_users_from_csv($filepath);
}

if (!wp_next_scheduled('wpma_ru_daily_user_import')) {
    wp_schedule_event(time(), 'daily', 'wpma_ru_daily_user_import');
}

Так импорт будет запускаться автоматически, если в папке появится обновлённый CSV.

Рекомендации по безопасности и производительности

Импорт пользователей может быть ресурсозатратным процессом, особенно если данных много. Чтобы избежать проблем, учитывайте следующее:

• Разбивайте импорт на части, например, по 50-100 пользователей за раз.
• Используйте транзакции и проверяйте ошибки при добавлении пользователей.
• Обязательно фильтруйте и валидируйте входные данные.
• Закрывайте доступ к CSV файлам и страницам импорта.
• Логируйте успешные и неудачные попытки импорта для отладки.

Если хотите более удобный и безопасный способ, рассмотрите плагин Import Users from CSV with Meta — он поддерживает все эти функции и интеграцию с WP.

Пример интеграции с WPRemark для автоматической рассылки приветственных писем

После успешного импорта пользователей часто нужно отправить им приветственные письма. С помощью плагина WPRemark можно автоматизировать этот процесс. Ниже пример, как после импорта отправить письмо:

add_action('wpma_ru_after_user_import', 'wpma_ru_send_welcome_email');
function wpma_ru_send_welcome_email($user_id) {
    if (!function_exists('wpremark_send_email')) {
        return;
    }
    $user = get_userdata($user_id);
    $subject = 'Добро пожаловать на наш сайт!';
    $message = 'Здравствуйте, ' . $user->first_name . '! Спасибо за регистрацию.';
    wpremark_send_email($user->user_email, $subject, $message);
}

Не забудьте вызвать do_action('wpma_ru_after_user_import', $user_id); внутри цикла импорта, чтобы триггерить рассылку.