ユーザーの操作

ユーザーの追加

ユーザーを追加するには、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 );

この関数は、ほとんどの定義済みのプロパティに対するフィルターを呼び出します。

この関数は、(ユーザー ID が存在しない場合) ユーザーを作成する際に 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() を使用します。

現在のユーザーのパスワードが更新される場合、Cookies はクリアされます !

使用パラメータについての完全な説明は、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() に関する関数リファレンスを参照してください。

原文 / 日本語訳

s
検索
c
新規投稿を作成する
r
返信
e
編集
t
ページのトップへ
j
次の投稿やコメントに移動
k
前の投稿やコメントに移動
o
コメントの表示を切替
esc
投稿やコメントの編集をキャンセル