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

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

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

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

Рассмотрим примеры импорта из CSV файла, добавим проверку данных, назначим роли и настройки.

Подготовка CSV файла для импорта пользователей

Первый шаг — подготовить файл с данными пользователей. Формат CSV очень удобен и универсален. Вот минимальный набор полей, которые нужны для создания пользователя:

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

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

ivanov,ivanov@example.com,SecurePass123,subscriber,Ivan,Ivanov

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

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

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

function wpmoney_import_users_from_csv($file_path) {
    if (!file_exists($file_path)) {
        return new WP_Error('file_not_found', 'CSV файл не найден');
    }
    
    $handle = fopen($file_path, 'r');
    if (!$handle) {
        return new WP_Error('file_open_error', 'Не удалось открыть CSV файл');
    }
    
    $imported = 0;
    $skipped = 0;
    
    while (($data = fgetcsv($handle, 1000, ',')) !== false) {
        // Пропускаем пустые строки и заголовок
        if (count($data) < 6 || strtolower($data[0]) === 'user_login') {
            continue;
        }
        list($user_login, $user_email, $user_pass, $role, $first_name, $last_name) = $data;
        
        // Проверяем, существует ли уже пользователь с таким логином или email
        if (username_exists($user_login) || email_exists($user_email)) {
            $skipped++;
            continue;
        }
        
        if (empty($user_pass)) {
            $user_pass = wp_generate_password(12, false);
        }
        
        $userdata = array(
            'user_login' => $user_login,
            'user_email' => $user_email,
            'user_pass'  => $user_pass,
            'role'       => $role,
            'first_name' => $first_name,
            'last_name'  => $last_name
        );
        
        $user_id = wp_insert_user($userdata);
        
        if (is_wp_error($user_id)) {
            $skipped++;
            continue;
        }
        $imported++;
    }
    fclose($handle);
    
    return array('imported' => $imported, 'skipped' => $skipped);
}

Эта функция открывает файл, построчно читает CSV, проверяет уникальность логина и email, создаёт пользователей с указанными ролями и именами. Если пароль пустой — генерируется случайный.

Использование функции импорта

Чтобы запустить импорт, достаточно вызвать функцию с путём к файлу:

$result = wpmoney_import_users_from_csv(ABSPATH . 'wp-content/uploads/users.csv');
if (is_wp_error($result)) {
    echo 'Ошибка: ' . $result->get_error_message();
} else {
    echo 'Импортировано пользователей: ' . $result['imported'] . ', пропущено: ' . $result['skipped'];
}

Расширение функции: добавление метаданных и валидация

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

Пример дополнения кода для сохранения телефона и внешнего ID:

function wpmoney_import_users_from_csv($file_path) {
    // ... предыдущий код ...
    while (($data = fgetcsv($handle, 1000, ',')) !== false) {
        if (count($data) < 8) { // теперь минимум 8 колонок
            continue;
        }
        list($user_login, $user_email, $user_pass, $role, $first_name, $last_name, $phone, $external_id) = $data;
        
        // ... проверка и создание пользователя ...
        
        if (!is_wp_error($user_id)) {
            update_user_meta($user_id, 'phone', sanitize_text_field($phone));
            update_user_meta($user_id, 'external_id', sanitize_text_field($external_id));
        }
    }
    // ... остальной код ...
}

Также полезно добавить валидацию email и логина с помощью регулярных выражений и функции is_email(), чтобы исключить некорректные записи.

Как запустить импорт через админ-панель с помощью плагина

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

Пример простого плагина с формой загрузки файла:

/*
Plugin Name: WPMoney User CSV Importer
Description: Импорт пользователей из CSV файла
Version: 1.0
Author: WPMoney
*/

add_action('admin_menu', function() {
    add_users_page('Импорт пользователей CSV', 'Импорт CSV', 'manage_options', 'wpmoney-user-import', 'wpmoney_user_import_page');
});

function wpmoney_user_import_page() {
    if (!empty($_FILES['csv_file']['tmp_name'])) {
        $result = wpmoney_import_users_from_csv($_FILES['csv_file']['tmp_name']);
        if (is_wp_error($result)) {
            echo '<div class="error"><p>' . esc_html($result->get_error_message()) . '</p></div>';
        } else {
            echo '<div class="updated"><p>Импортировано: ' . intval($result['imported']) . ', пропущено: ' . intval($result['skipped']) . '</p></div>';
        }
    }
    ?>
    <h2>Импорт пользователей из CSV</h2>
    <form method="post" enctype="multipart/form-data">
        <input type="file" name="csv_file" accept=".csv" required />
        <input type="submit" class="button button-primary" value="Импортировать" />
    </form>
    <?php
}

// Функция импорта из предыдущего примера здесь

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

Альтернативы: плагины для импорта пользователей

Если нужен готовый вариант, можно использовать популярные плагины:

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

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

Заключение

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

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