get_dashboard_url

（3.1.0以降）
get_dashboard_url - ダッシュボートページのURLを取得する

説明

string get_dashboard_url( [ int $user_id = 0 [ , string $path = '' [ , string $scheme = 'admin' ] ] ] )

ダッシュボートページのURLを取得する。

パラメータ

$user_id
ユーザーIDを指定（省略時は0）。
$path
管理者ページのパス名を指定（省略時は''）。
$scheme
スキーマとして'admin'、'http'、'https'を指定（省略時は'admin'）。

返り値

ユーザーのロールに応じたダッシュボードページのURLを返す。

注意

基本的にはマルチサイト向けの関数で、通常のシングルサイトではパラメータ$user_idは使用されず、 admin_url関数が適用される。ユーザーとサイトの状況に応じて異なるダッシュボードのURLを取得できる。

ユーザーがどのサイトにも属していない場合、ユーザーダッシュボードが適用される。
ユーザーが現在のサイトに属している場合、現在のサイトのダッシュボードが適用される。
ユーザーが現在のサイトを編集できない場合、ユーザーのプライマリサイトのダッシュボードが適用される。

使用例

現在のユーザーのダッシュボートページのURLを取得する。
```
<?php $url = get_dashboard_url( ); ?>
```
ユーザーIDを指定してそのダッシュボートページのURLを取得する。
```
<?php $url = get_dashboard_url( $user->ID ); ?>
```

フィルター

[3.1.0]URLを返す前に'user_dashboard_url'フィルターを呼び出す。パラメータ$urlにはダッシュボードページのURLが、そのほかのパラメータには本関数が受け取った内容が格納されている。

return apply_filters( 'user_dashboard_url', $url, $user_id, $path, $scheme );

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/link-template.php

最終更新 : 2019年10月17日 13:56

参考

Code Reference: get_dashboard_url

お勧め

子カテゴリのアーカイブページを親カテゴリ用のテンプレートファイルで表示しよう（2011年12月8日更新）

少し前に投稿した「適切なテンプレートファイルを用意してテンプレート内の振り分け処理を無くす」で説明した通り、特定のカテゴリ専用のテンプレートとしてcategory-○○.phpを用意することで、category.phpやarchive.php内で振り分けを行う必要がなくなる。ただ、すべてのカテゴリ分を用意するのは効率的ではないし、特に子カテゴリについては親カテゴリと共通内容になるケースが多いのではないだろうか。ここでは、子カテゴリの個別テンプレートファイルを作らず、親カテゴリのテンプレートを利用する方法を紹介する。

管理画面の'アイキャッチ画像'を'写真'に変える（2013年1月23日更新）

クライアント向けに専用のテーマを提供する際、稀に管理画面内の用語の変更を依頼されることがある。今回は、'アイキャッチ画像'だとわかりにくいので'写真'に変えてほしいということだった。

5.7の機能拡張：投稿一覧画面向けのフィルター（2021年2月18日更新）

昨日、予定通り公開された「WordPress 5.7 Beta 3（以降Beta 3）」。WordPressはバージョンアップ毎にアクションやフィルターが追加されており、今回のバージョンアップでは投稿一覧画面に影響を与えるフィルターが追加されていた。

今回追加したものは、REST API / Usersの使用をログイン時のみ使用できるように制限する機能である。この機能を有効にすることで、管理者情報が漏洩するリスクを低減させる効果が期待できる。

タイトルのみをキーワード検索する（2014年4月3日更新）

WordPressのキーワード検索は、投稿タイトルと本文のどちらかに指定したキーワードが含まれているかを調べるわけだが、時々タイトルだけとか、逆に本文だけ検索したいケースがある。

説明

パラメータ

返り値

注意

使用例

フィルター

アクション

ソースファイル

関連

参考

お勧め