WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

wp_create_user() WP 2.0

Регистрирует нового пользователя. Указываются логин (имя), пароль и email.

Все что делает функция — это добавляет слэши в логин/email и вызывает wp_insert_user().

Используйте аналогичную функцию: wp_insert_user(), когда нужно указать дополнительные параметры: роль, метаполя и т.д.

Работает на основе: wp_insert_user()
Основа для: register_new_user()

Хуков нет.

Возвращает

Число/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 5.5.1

wp-includes/user.php
<?php
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 );
}

Cвязанные функции

Из метки: Пользователи (_user)

Еще из раздела: Добавление/удаление юзеров

8 комментов