Функция wp_create_user() │ WP 2.0.0

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

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

Функция возвращает либо ID нового пользователя, либо объект WP_Error, если создать пользователя не удалось.

Синтаксис

wp_create_user( $username, $password, $email );

Параметры

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

Пример использования

Создание нового пользователя

Если WordPress не может создать пользователя, он вернет объект WP_Error. В этом случае выводим соответствующее сообщение об ошибке:

$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() для более полного создания нового пользователя, если вам нужно указать другую информацию.

История изменений

• С версии 2.0.0 — функция была реализована.

Как работает функция

Функция wp_create_user() выглядит следующим образом:

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 ); // добавляем пользователя в базу данных
}

В этой функции параметры обрабатываются и затем передаются в wp_insert_user(), которая и выполняет фактическое добавление пользователя.

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

Пользователи

• clean_user_cache()
• current_user_can()
• delete_user_option()
• get_current_user_id()
• get_edit_user_link()
• get_user_by()
• get_user_option()
• get_userdata()
• get_users()
• is_user_logged_in()
• wp_destroy_other_sessions()
• wp_get_current_user()
• wp_insert_user()
• wp_list_users()
• wp_send_new_user_notifications()
• wp_set_current_user()
• wp_update_user()
• WP_User()

Вставка и удаление пользователей

• register_new_user()
• wp_delete_user()
• wp_new_user_notification()

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