wp_login_url() の使い方｜説明・引数・注意点

説明

基本構文

wp_login_url( string $redirect = '', bool $force_reauth = false ): string

引数

• $redirect：ログイン後の遷移先
• $force_reauth：再認証を強制するか

戻り値

ログインページのURL。

使い方（サンプル）

echo esc_url( wp_login_url( home_url( '/' ) ) );

注意点

• ログインURLを変更するプラグインを使っている場合も、変更後のURLが返ります。

実務での使いどころ

• ログインページへの、リンクを作るとき。
• ログイン後に、元のページへ戻したいとき（$redirect を指定）。

よくあるミスと対処

• /wp-login.php を直接書いている。ログインURLを変更するプラグインを使うと、壊れる。
• $redirect を指定せず、ログイン後に、意図しないページへ移動する。

NG例

echo '<a href="/wp-login.php">ログイン</a>';

OK例

echo '<a href="' . esc_url( wp_login_url( get_permalink() ) ) . '">ログイン</a>';

使い分け早見表

関連項目

wp_logout_url()、wp_lostpassword_url()

公式リファレンス：wp_login_url() | Function | WordPress Developer Resources