この記事は最後に更新してから1年以上経過しています。

管理者ページに文言を表示する

管理者ページのカスタマイズ 基本編

説明

お客様向けに管理者ページをカスタマイズする機会が増えてきている。カスタマイズするページや表示場所、表示内容によっていくつかの手段があるが、今回はページの冒頭部分に任意の文言を表示する方法を紹介する。

admin_noticesアクションがお手軽

管理者ページの冒頭部分に何かを表示したいのであれば、admin_noticesアクションが利用するのが簡単である。このアクションは、原則的にすべての管理者ページを表示する際に実行されるようになっており、実行されるアクション関数によりページタイトルのすぐ上に好みの文言を表示できる。 具体的には、テーマであればfunctions.phpに次のように記述すればいい。 
add_action( 'admin_notices', 'mytheme_notices' );

function mytheme_notices() {
?>
<p>ちょっとしたお知らせです。</p>
<?php
}
この指定では、すべての管理者ページに指定された内容（ここでは「ちょっとしたお知らせです。」）が表示される。もし特定のページのみで表示したいのであれば、管理者ページのファイル名が格納されている $pagenowを利用するのがいいだろう。 例えば、ダッシュボードページだけに表示する場合は次のように記述する。 
global $pagenow;
if ( isset( $pagenow ) && $pagenow == 'index.php' )
	add_action( 'admin_notices', 'mytheme_notices' );
または、 
function mytheme_notices() {
	global $pagenow;
	if ( $pagenow == 'index.php' ) {
?>
<p>ちょっとしたお知らせです。</p>
<?php
	}
}
上記の2つは、表示するページがダッシュボードページかどうかの判断をどの段階で行うかの違いであり、好みのどちらかの方法を選択すればいい。

最終更新 : 2012年04月19日 17:33

関連

お勧め

wp_print_inline_script_tag（2021年4月19日 更新）

void wp_print_inline_script_tag( string $javascript [ , array $attributes = array() ] )
インラインJavaScriptを含むscript要素を出力する。

register_rest_route（2022年8月17日 更新）

bool register_rest_route( string $namespace, string $route [ , array $args = array() [ , bool $override = false ] ] )
REST APIのルートを登録する。

wp_determine_option_autoload_value（2024年7月22日 更新）

string wp_determine_option_autoload_value( string $option, mixed $value, mixed $serialized_value, boo l |string $autoload )
自動ロードのトリガー値を取得する。

single_tag_title（2018年5月27日 更新）

string single_tag_title( [ string $prefix = '' [ , bool $display = true ] ] )
投稿タグアーカイブページの投稿タグ名を取得し、パラメータ$displayがtrueならば表示する。$displayがfalseの場合は、文字列として返す。

home_url（2023年3月31日 更新）

string home_url( [ string $path = '' [ , string $scheme = null ] ] )
現在のブログ（サイト）のホームURLを取得する。ホームURLは、管理者ページの「設定」-「一般」の「サイトのアドレス(URL)」のこと。