## 插入用戶 要添加用戶使用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 這是一個管理功能。