ユーザーの追加
ユーザーを追加するには、wp_create_user()
か wp_insert_user()
を使います。
wp_create_user()
はユーザー名、パスワード、メールアドレスのパラメータのみを使用してユーザーを作成します。一方、wp_insert_user()
はユーザーとそのプロパティを記述する配列またはオブジェクトを受け取ってユーザーを作成します。
ユーザーの作成
wp_create_user()
を使用して新しい WordPress ユーザーを作成できます。
wp_slash()
を使用します。PHP の compact() 関数を使用して、これらの値から配列を作成します。wp_insert_user()
は、挿入操作を実行します。
使用パラメータについての完全な説明は、wp_create_user()
に関する関数リファレンスを参照してください。
作成の例
// check if the username is taken
$user_id = username_exists( $user_name );
// check that the email address does not belong to a registered user
if ( ! $user_id && email_exists( $user_email ) === false ) {
// create a random password
$random_password = wp_generate_password( 12, false );
// create the user
$user_id = wp_create_user(
$user_name,
$random_password,
$user_email
);
}
ユーザーの挿入
wp_insert_user( $userdata );
この関数は、ほとんどの定義済みのプロパティに対するフィルターを呼び出します。
user_register
というアクションを実行します。
この関数は、(ユーザー ID が存在する場合) ユーザーを更新する際に、profile_update
というアクションを実行します。
使用パラメータについての完全な説明は、wp_insert_user()
に関する関数リファレンスを参照してください。
挿入の例
以下は、Web サイト・プロフィール・フィールドに記入された新規ユーザーを挿入する方法を示す例です。
$username = $_POST['username'];
$password = $_POST['password'];
$website = $_POST['website'];
$user_data = [
'user_login' => $username,
'user_pass' => $password,
'user_url' => $website,
];
$user_id = wp_insert_user( $user_data );
// success
if ( ! is_wp_error( $user_id ) ) {
echo 'User created: ' . $user_id;
}
ユーザーの更新
wp_update_user()
は、データベース内の単一のユーザーを更新します。更新データは、配列/オブジェクト $userdata
で渡されます。
単一のユーザー・メタデータを更新するには、代わりに update_user_meta()
を使用します。新しいユーザーを作成するには、代わりに wp_insert_user()
を使用します。
使用パラメータについての完全な説明は、wp_update_user()
に関する関数リファレンスを参照してください。
更新の例
以下は、ユーザーの Web サイト・プロフィール・フィールドを更新する方法を示す例です。
$user_id = 1;
$website = 'https://wordpress.org';
$user_id = wp_update_user(
array(
'ID' => $user_id,
'user_url' => $website,
)
);
if ( is_wp_error( $user_id ) ) {
// error
} else {
// success
}
ユーザーの削除
wp_delete_user()
はユーザーを削除し、付随するエンティティを別のユーザー ID に再割り当てします。
deleted_user
というアクションを実行します。
$reassign
パラメータに有効なユーザー ID が設定されていない場合、削除されたユーザーに属するすべてのエンティティが削除されます !
使用パラメータについての完全な説明は、wp_delete_user()
に関する関数リファレンスを参照してください。