wp_delete_user()


WordPressのwp_delete_user()関数は、指定したユーザーをデータベースから削除するために使用されます。この関数は、ユーザーIDを指定してユーザーを削除するか、特定のユーザーに属するすべてのコンテンツを別のユーザーに再割り当てしてから削除することができます。

構文

wp_delete_user( int $id, int $reassign = null );

引数の説明:

  • $id (int) — 削除するユーザーのID。
  • $reassign (int) — 削除するユーザーのコンテンツを再割り当てする先のユーザーID。nullの場合、コンテンツは削除されます。

例1: ユーザーを削除する

この例では、IDが2のユーザーを削除します。

<?php wp_delete_user(2); ?>

例2: ユーザーを削除し、コンテンツを別のユーザーに再割り当てする

この例では、IDが3のユーザーを削除し、そのユーザーのコンテンツをIDが5のユーザーに再割り当てします。

<?php wp_delete_user(3, 5); ?>

例3: 現在のユーザーを削除する

この例では、現在ログインしているユーザーを削除します。

<?php wp_delete_user(get_current_user_id()); ?>

例4: 特定のユーザーを削除する（ユーザー名を使用）

この例では、ユーザー名が「example_user」のユーザーを削除します。

<?php $user = get_user_by('login', 'example_user'); wp_delete_user($user->ID); ?>

例5: ユーザーを削除し、コンテンツを削除しない

この例では、IDが4のユーザーを削除し、そのユーザーのコンテンツを削除しません。

<?php wp_delete_user(4, null); ?>

例6: ユーザーを削除し、コンテンツを管理者に再割り当てする

この例では、IDが6のユーザーを削除し、そのユーザーのコンテンツを管理者（IDが1のユーザー）に再割り当てします。

<?php wp_delete_user(6, 1); ?>

例7: ユーザーを削除する前に確認する

この例では、ユーザーを削除する前に確認を行います。

<?php if (current_user_can('delete_users')) { wp_delete_user(7); } ?>

例8: ユーザーを削除し、エラーメッセージを表示する

この例では、ユーザーを削除し、エラーが発生した場合にメッセージを表示します。

<?php if (!wp_delete_user(8)) { echo 'ユーザーの削除に失敗しました。'; } ?>

注意点

  • ユーザーを削除すると、そのユーザーのすべてのデータがデータベースから削除されます。削除前に必ずバックアップを取ってください。
  • 管理者権限を持つユーザーは、自分自身を削除することはできません。
  • ユーザーを削除する前に、そのユーザーが所有するコンテンツを適切に処理してください。

関連機能：