register_new_user() を利用したWordPressの新規ユーザー登録処理について解説

<?php
// 入力されたユーザー名(例: フォームから受け取ったもの)
$user_login = $_POST['user_login'];
// ユーザー名をサニタイズする
$sanitized_user_login = sanitize_user( $user_login );
// ユーザー名の形式を検証する
if ( ! validate_username( $sanitized_user_login ) ) {
    // エラー追加の例: 不正な文字が含まれている場合
    $errors->add( 'invalid_username', 'ユーザー名に使用できない文字が含まれています。' );
}
?>

// 例えば、入力が "ExampleUser!@" だった場合、サニタイズ後は "ExampleUser" となり、エラーがなければ登録処理が続行されます。

<?php
// 入力されたメールアドレス(例: フォームから受け取ったもの)
$user_email = $_POST['user_email'];
// メールアドレスの形式確認
if ( ! is_email( $user_email ) ) {
    $errors->add( 'invalid_email', 'メールアドレスの形式が正しくありません。' );
}
// メールアドレスの重複チェック
if ( email_exists( $user_email ) ) {
    $errors->add( 'email_exists', 'このメールアドレスは既に使用されています。' );
}
?>

// 正しいメール形式かつ重複していなければ、登録処理の次のステップへ進むことができます。

<?php
// 12文字のランダムパスワードを生成(特殊文字は含めない設定)
$user_pass = wp_generate_password( 12, false );
?>

// 例: "aBcD1234EfGh" のような文字列が生成されます。

<?php
// ユーザー情報のサニタイズ後にユーザーを作成
$user_id = wp_create_user( $sanitized_user_login, $user_pass, $user_email );
// ユーザー作成に失敗した場合、WP_Error オブジェクトが返るのでエラーチェックを行う
if ( is_wp_error( $user_id ) ) {
    // エラー内容を処理(例: エラーメッセージを返す)
    return $user_id;
}
?>

// 正常に実行された場合、$user_id は新規ユーザーのIDとなります。
// エラーが発生した場合、適切なエラーメッセージが $user_id 内に設定されます。

<?php
// wp_create_user() で正常にユーザーが作成された後の処理として
update_user_meta( $user_id, 'default_password_nag', true );
?>

// この設定により、ユーザーは初回ログイン時にパスワード変更画面へ遷移されます。

<?php
// クッキーから取得した言語情報をサニタイズして設定する例
if ( ! empty( $_COOKIE['wp_lang'] ) ) {
    $user_lang = sanitize_text_field( $_COOKIE['wp_lang'] );
    if ( in_array( $user_lang, get_available_languages(), true ) ) {
        // ユーザーのロケール情報を更新する
        update_user_meta( $user_id, 'locale', $user_lang );
    }
}
?>

// 有効な言語情報が取得できた場合、ユーザーの表示言語が指定した言語に更新されます。

<?php
// エラーオブジェクトを初期化
$errors = new WP_Error();
// ユーザー名が空の場合、エラーを追加する例
if ( '' === trim( $user_login ) ) {
    $errors->add( 'empty_username', 'ユーザー名が入力されていません。' );
}
?>

// 上記の場合、$errors オブジェクト内に 'empty_username' というエラーコードと該当メッセージが追加されます。

<?php
// エラーが追加されているかチェックする
if ( $errors->has_errors() ) {
    // エラーがあれば処理を中断し、エラーオブジェクトを返す
    return $errors;
}
?>

// エラーが存在する場合、処理はここで停止し、WP_Error オブジェクトに含まれるエラー内容が利用可能になります。

<?php
// functions.php などに記述する例
add_action( 'register_post', 'custom_register_post_validation', 10, 3 );
function custom_register_post_validation( $sanitized_user_login, $user_email, $errors ) {
    // 特定のドメイン (example.com) を禁止する例
    if ( strpos( $user_email, '@example.com' ) !== false ) {
        $errors->add( 'invalid_email_domain', 'example.com のメールアドレスは使用できません。' );
    }
}
?>

// 指定のメールドメインが入力された場合、$errors 内にエラーが追加され、ユーザー登録は中断されます。

<?php
// ユーザー登録完了後に実行するカスタム処理の例
add_action( 'register_new_user', 'custom_after_user_registration' );
function custom_after_user_registration( $user_id ) {
    // ユーザー情報を取得してウェルカムメールを送信する例
    $user_info = get_userdata( $user_id );
    wp_mail( $user_info->user_email, 'ようこそ！', 'ユーザー登録が完了しました。' );
}
?>

// ユーザー登録が完了すると、指定されたユーザーにウェルカムメールが送信されます。