wp_create_user()
Регистрирует нового пользователя. Указываются логин (имя), пароль и email.
Все что делает функция — это добавляет слэши в логин/email и вызывает wp_insert_user().
Используйте аналогичную функцию: wp_insert_user(), когда нужно указать дополнительные параметры: роль, метаполя и т.д.
Работает на основе: wp_insert_user()
Основа для: register_new_user()
Хуков нет.
Возвращает
int|WP_Error. ID, если удалось добавить пользователя. Если создать не удалось (имя или мыло уже существуют), вернет объект WP_Error со следующими сообщениями об ошибке:
- empty_user_login — невозможно создать пользователя, потому что логин не указан (пуст).
- existing_user_login — такой пользователь уже зарегистрирован.
- existing_user_email — такой email уже существует.
Подробнее см. wp_insert_user().
Использование
$user_id = wp_create_user( $username, $password, $email );
- $username(строка) (обязательный)
- Имя создаваемого пользователя (логин).
- $password(строка) (обязательный)
- Пароль создаваемого пользователя.
- $email(строка)
- E-mail создаваемого пользователя.
По умолчанию: ''
Примеры
#1 Пример создания нового пользователя.
Если WordPress не сможет создать пользователя, то он вернет объект ошибки, выведем в этом случае сообщение из этого объекта:
$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 'Юзер создан.';
}
Заметки
- Смотрите: wp_insert_user() More complete way to create a new user.
Список изменений
| С версии 2.0.0 | Введена. |
Код wp_create_user() wp create user WP 6.6.1
function wp_create_user( $username, $password, $email = '' ) {
$user_login = wp_slash( $username );
$user_email = wp_slash( $email );
$user_pass = $password;
$userdata = compact( 'user_login', 'user_email', 'user_pass' );
return wp_insert_user( $userdata );
}