Функция wp_create_user() в WordPress с примерами

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

wp_create_user( string $username, string $password, string $email = '' ): int|WP_Error

Параметры:

• $username (строка, обязательный): Логин создаваемого пользователя.
• $password (строка, обязательный): Пароль создаваемого пользователя.
• $email (строка, необязательный): Email пользователя. По умолчанию — пустая строка.

Возвращаемое значение:

• ID пользователя в случае успешного создания.
• WP_Error, если регистрация не удалась (например, если пользователь с таким логином или email уже существует).

Описание:

• Функция wp_create_user() — это упрощенный вариант для создания пользователя. Она использует более сложную функцию wp_insert_user(), которая позволяет указывать больше параметров (например, роль пользователя, метаполя и т.д.).
• Если необходимо создать пользователя с конкретными правами, метаполями и другими настройками, рекомендуется использовать wp_insert_user().
• wp_create_user() автоматически проверяет уникальность логина и email, и в случае успешного создания пользователя отправляет уведомление о создании аккаунта с логином и паролем.

1. Пример создания нового пользователя

Этот код создает нового пользователя с логином $user_name, сгенерированным паролем и указанным email:

$user_name = 'newuser';
$user_email = '[email protected]';
$random_password = wp_generate_password( 12 );

$user_id = wp_create_user( $user_name, $random_password, $user_email );

if ( is_wp_error( $user_id ) ) {
    echo 'Ошибка создания пользователя: ' . $user_id->get_error_message();
} else {
    echo 'Пользователь успешно создан с ID: ' . $user_id;
}

2. Проверка на существование пользователя перед созданием

Прежде чем создавать пользователя, можно проверить, существует ли уже пользователь с указанным логином или email:

$user_name = 'newuser';
$user_email = '[email protected]';
$user_id = username_exists( $user_name );

if ( ! $user_id && ! email_exists( $user_email ) ) {
    $random_password = wp_generate_password( 12 );
    $user_id = wp_create_user( $user_name, $random_password, $user_email );
    echo 'Пользователь создан с ID: ' . $user_id;
} else {
    echo 'Такой пользователь или email уже существуют.';
}

3. Обработка ошибок

Если при создании пользователя возникают ошибки (например, уже существует пользователь с таким логином или email), wp_create_user() возвращает объект WP_Error, который можно обработать следующим образом:

$user_name = 'existinguser';
$user_email = '[email protected]';
$random_password = wp_generate_password( 12 );

$user_id = wp_create_user( $user_name, $random_password, $user_email );

if ( is_wp_error( $user_id ) ) {
    echo 'Ошибка: ' . $user_id->get_error_message();
} else {
    echo 'Пользователь успешно создан с ID: ' . $user_id;
}

Заключение:

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