wp_insert_user( array|object|WP_User $userdata )

使用示例

• 示例1

  wp_insert_user函数需要一个用户数据数组（或对象）来创建用户。$userdata的完整阵列版本如下：

  $userdata = array(
  	'ID' 					=> 0, 	//(int) User ID. If supplied, the user will be updated.
  	'user_pass'				=> '', 	//(string) The plain-text user password.
  	'user_login' 			=> '', 	//(string) The user's login username.
  	'user_nicename' 		=> '', 	//(string) The URL-friendly user name.
  	'user_url' 				=> '', 	//(string) The user URL.
  	'user_email' 			=> '', 	//(string) The user email address.
  	'display_name' 			=> '', 	//(string) The user's display name. Default is the user's username.
  	'nickname' 				=> '', 	//(string) The user's nickname. Default is the user's username.
  	'first_name' 			=> '', 	//(string) The user's first name. For new users, will be used to build the first part of the user's display name if $display_name is not specified.
  	'last_name' 			=> '', 	//(string) The user's last name. For new users, will be used to build the second part of the user's display name if $display_name is not specified.
  	'description' 			=> '', 	//(string) The user's biographical description.
  	'rich_editing' 			=> '', 	//(string|bool) Whether to enable the rich-editor for the user. False if not empty.
  	'syntax_highlighting' 	=> '', 	//(string|bool) Whether to enable the rich code editor for the user. False if not empty.
  	'comment_shortcuts' 	=> '', 	//(string|bool) Whether to enable comment moderation keyboard shortcuts for the user. Default false.
  	'admin_color' 			=> '', 	//(string) Admin color scheme for the user. Default 'fresh'.
  	'use_ssl' 				=> '', 	//(bool) Whether the user should always access the admin over https. Default false.
  	'user_registered' 		=> '', 	//(string) Date the user registered. Format is 'Y-m-d H:i:s'.
  	'show_admin_bar_front' 	=> '', 	//(string|bool) Whether to display the Admin Bar for the user on the site's front end. Default true.
  	'role' 					=> '', 	//(string) User's role.
  	'locale' 				=> '', 	//(string) User's locale. Default empty.
  
  );

• 示例2

  实例

  下面是一个示例，显示了如何在个人资料网站字段已填充的情况下插入新用户。

  $website = "http://example.com";
  $userdata = array(
      'user_login' =>  'login_name',
      'user_url'   =>  $website,
      'user_pass'  =>  NULL // When creating an user, `user_pass` is expected.
  );
  
  $user_id = wp_insert_user( $userdata ) ;
  
  // On success.
  if ( ! is_wp_error( $user_id ) ) {
      echo "User created : ". $user_id;
  }
  

• 示例3

  数据库中的user_url长度限制为100。

  但是wp_insert_user不会返回WP_Error。如果超过此大小，则返回0。

  这可能是一个很好的改进，因为我刚刚过去30分钟，找到了问题所在。

  提前感谢，

  :)

• 示例4

  'role'应该是小写，否则它将无法工作。

• 示例5

  我的朋友Gregory因为使用了不适当的函数来加密密码而被10次踩，但我觉得大家可能没有理解他关于在使用wp_insert_user()而不是wp_update_user()更新用户时需要手动加密密码的观点。

  “在wp_update_user()中的加密，如果直接调用，则为明文。” – 第1760行。

  因此正确的用法是smth，如：

  $existing_user_id = wp_insert_user( array(
  
  	/**
       * The existing user id
       */
      'ID' 		 =>  $existing_user_id,
  
      /**
       * I think you need to supply the user login though i'm not too sure,
       * When i tried this without passing in user_login it gave me errors idk why
       * User login won't change tho as usernames in wordpress are permanent
       */
      'user_login' =>  $user_login,
  
      /**
       * Hash the new password when updating an existing user using built in hashing function
       */
      'user_pass'  =>  wp_hash_password( $new_password ),
  
  ) ) ;

• 示例6

  下面是一个演示如何插入新用户的示例。

  $data = array(
      'user_login'           => 'login_name', // the user's login username.
      'user_pass'	           => 'login_password', // not necessary to hash password ( The plain-text user password ).
      'show_admin_bar_front' => false // display the Admin Bar for the user 'true' or 'false'
  );
   
  $user_id = wp_insert_user( $data );
   
  if ( ! is_wp_error( $user_id ) ) {
  	
      echo "User ID : ". $user_id;
  	
  }
  

• 示例7

  $userdata必须转义。以这种方式创建的帐户您将无法登录：

  $userdata = array(
  	'user_login' => 'test',
  	'user_pass' => "123'456",
  	'user_email' => 'test@example.com',
  );
  wp_insert_user( $userdata );

  以下是正确的代码：

  wp_insert_user( wp_slash( $userdata ) );

  P.S. 在 WP 5.5.3 中测试

• 示例8

  键入时，user_login不能为空
  

          $userdata = array(
              'user_email'            => $email,   
              'first_name'            => $fname,  
              'last_name'             => $lname,  
              'role'                  => 'subscriber',
          );  

  函数返回
  WP_Error Object ( [errors] => Array ( [empty_user_login] => Array ( [0] => Cannot create a user with an empty login name. ) ) [error_data] => Array ( ) [additional_data:protected] => Array ( ) )

• 示例9

  文档中说show_admin_bar_front可以是布尔值，但我想这行不通，在第一次使用此函数时，我的意思是，在创建用户时，必须使用字符串类型。

• 示例10

  如果您决定使用wp_insert_user()更新现有用户，则必须使用md5函数对密码进行编码。可能这是一个错误。

  // Tested with version WP 4.5
  $userdata = array(
  	'ID' => $user_id, // ID of existing user
  	'user_login' =>  'login_name',
  	'user_pass'  =>  md5($new_password) // no plain password here!
  ); 
  
  $user_id = wp_insert_user( $userdata ) ;