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

説明

基本構文

admin_url( string $path = '', string $scheme = 'admin' ): string

引数

• $path：管理画面内のパス（例：options-general.php）
• $scheme：スキーム

戻り値

管理画面のURL。

使い方（サンプル）

echo esc_url( admin_url( 'admin-ajax.php' ) );

注意点

• Ajaxのエンドポイントとして admin-ajax.php を指定する場面でよく使います。

実務での使いどころ

• 管理画面のURLを作るとき（設定ページへのリンクなど）。
• Ajaxの送信先（admin-ajax.php）を、JavaScriptへ渡すとき。

よくあるミスと対処

• /wp-admin/ を直接書いている。WordPressを、サブディレクトリに置いたときや、ドメインを変えたときに、壊れる。
• Ajaxの送信先に、固定のURLを使っている。admin_url( 'admin-ajax.php' ) を使う。

NG例

wp_localize_script( 'my-script', 'myAjax', array( 'url' => '/wp-admin/admin-ajax.php' ) );

OK例

wp_localize_script( 'my-script', 'myAjax', array( 'url' => admin_url( 'admin-ajax.php' ) ) );

使い分け早見表

関連項目

site_url()、home_url()、wp_login_url()

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