## 插入用户 要添加用户使用ether wp_insert_user或wp_create_user。 wp_create_user只能创建一个用户,不允许管理任何额外的用户字段。 wp_insert_user允许填写所有用户字段。 ``` <?php wp_insert_user( $userdata ); ?> ``` ## 参数 $userdata (混合)(必需)用户数据数组,stdClass或WP_User对象。 Default: None ## 返回值 (混合)如果成功,返回新创建的用户的user_id,否则返回一个WP_Error对象。 ## 例子 下面是一个示例,显示如何插入一个新的用户的网站配置文件字段填充。 ``` <?php $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; } ?> ``` 如果成功,返回新创建的用户的user_id,否则返回一个WP_Error对象。 $ userdata数组可以包含以下字段 |字段名称|描述|关联过滤器| |---|---|---|| |ID |将用于更新现有用户的整数。 |(没有)| |user_pass |一个包含用户明文密码的字符串。|pre_user_pass| |user_login |包含用户登录用户名的字符串。|pre_user_login| |user_nicename |包含用户的URL友好名称的字符串。 默认是用户的用户名。 |pre_user_nicename| |user_url |包含用户网站的用户URL的字符串。|pre_user_url| |user_email |包含用户电子邮件地址的字符串。 |pre_user_email| |display_name | 将在网站上显示的字符串。 默认为用户的用户名。 很可能您会想通过晦涩(即不使用和删除默认管理员用户)来改变外观和安全性。|pre_user_display_name| |nickname |用户的昵称,默认为用户的用户名。|pre_user_nickname| |first_name |用户的名字。 |pre_user_first_name| |last_name |用户的姓氏。|pre_user_last_name| |description |包含用户内容的字符串。|pre_user_description| |rich_editing |是否启用富编辑器的字符串。 假如不是空的话。|(none)| |user_registered| 用户注册的日期。 格式为Y-m-d H:i:s。|(none)| |role| 用于设置用户角色的字符串。 |(none)| |jabber|用户的Jabber帐户。|(none)| |aim| 用户的AOL IM帐号。 |(none)| |yim| 用户的Yahoo IM帐号。 |(none)| ## 笔记 - 用途: $wpdb WordPress数据库层。 - 用途: apply_filters() 调用大部分$ userdata字段的过滤器,前缀为'pre_user'。 见上述说明。 - 用途: do_action() 在更新时拨打“profile_update”钩子,提供用户的ID - 用途: do_action() 在创建提供用户ID的新用户时调用'user_register'钩子 如果没有ID,将创建一个新的用户。 如果您传递ID,则具有该ID的用户将被更新,并且如果在$ userdata中设置,则这些元字段将被更新,否则它们被设置为null: - first_name, - last_name, - nickname, - description, - rich_editing, - comment_shortcuts, - admin_color, - use_ssl, - show_admin_bar_front 当使用wp_insert_user执行更新操作时,user_pass应为散列密码,而不是纯文本密码。 ## 创建用户 ``` <?php wp_create_user( $username, $password, $email ); ?> ``` ## 描述 wp_create_user函数允许您将新用户插入WordPress数据库。 它使用$ wpdb类来转义变量值,准备将其插入到数据库中。 然后使用PHP compact()函数创建一个包含这些值的数组。 要创建具有附加参数的用户,请使用wp_insert_user()。 ## 例 如在wp-admin/upgrade-functions.php中使用的: ``` $user_id = username_exists( $user_name ); if ( !$user_id and email_exists($user_email) == false ) { $random_password = wp_generate_password( $length=12, $include_standard_special_chars=false ); $user_id = wp_create_user( $user_name, $random_password, $user_email ); } else { $random_password = __('User already exists. Password inherited.'); } ``` ## 参数 $username (string) (required) 要创建的用户的用户名。 Default: None $password (string) (required) 要创建的用户的密码 Default: None $email (string) (optional) 要创建的用户的电子邮件地址。 Default: None ## 退货 成功后 - 此函数返回创建的用户的用户ID。 在失败(用户名或电子邮件已存在)的情况下,函数返回一个错误对象,带有这些可能的值和消息; - empty_user_login, 无法创建具有空登录名的用户。 - existing_user_login, 此用户名已被注册。 - existing_user_email, 该邮箱地址已被注册。 ## 更新用户 ``` <?php wp_update_user( $userdata ) ?> ``` 描述 此功能可更新数据库中的单个用户。 此更新可以包含多个用户元数据作为数组。 要更新单个用户元数据,请改用update_user_meta()。 要创建新用户,请改用wp_insert_user()。 >[warning] 注意:如果当前用户的密码正在更新,那么cookie将被清除! ## 参数 $userdata (mixed) (required) 用户数据数组,stdClass或WP_User对象。 Default: None Return Values (mixed) 如果成功,返回user_id,否则返回一个WP_Error对象。 ## 例子 以下是一个示例,显示如何更新用户的网站配置文件字段: ``` <?php $user_id = 1; $website = 'http://wordpress.org'; $user_id = wp_update_user( array( 'ID' => $user_id, 'user_url' => $website ) ); if ( is_wp_error( $user_id ) ) { // There was an error, probably that user doesn't exist. } else { // Success! } ``` ## 删除用户 ``` <?php wp_delete_user( $id, $reassign ); ?></code> ``` ## 描述 删除用户,并可选地将帖子和链接重新分配给另一个用户。 如果$重新分配参数未分配给用户ID,则该用户的所有帖子将被删除。 传递被删除的用户ID的操作“delete_user”将在重新分配或删除帖子后运行。 用户元也将被删除用于该用户ID。 ## 参数 - $id (integer) (required) 用户ID Default: None - $reassign (integer) (optional) 重新分配帖子和链接到新的用户ID。 Default: null - Return Values (boolean) 完成时为真。 ## 例子 允许用户终止其用户帐户。 ``` wp_delete_user( $user_id ); ``` ##笔记 如果您希望在插件中使用此功能,则必须在插件函数中包含./wp-admin/includes/user.php文件,否则将抛出“未定义函数调用”错误 使用全局: (object) $wpdb 这是一个管理功能。