Функция 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().