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

管理者ページに文言を表示する - 管理者ページのカスタマイズ 基本編

説明

お客様向けに管理者ページをカスタマイズする機会が増えてきている。カスタマイズするページや表示場所、表示内容によっていくつかの手段があるが、今回はページの冒頭部分に任意の文言を表示する方法を紹介する。
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つは、表示するページがダッシュボードページかどうかの判断をどの段階で行うかの違いであり、好みのどちらかの方法を選択すればいい。

関連

  • add_action - アクション関数を追加する
  • $pagenow - 管理ページのページファイル名

お勧めコンテンツ

next_comments_link(2010年2月4日 登録)

void next_comments_link( [ string $label = '' ] )
次のコメント一覧ページのリンクテキストを表示する。

get_day_link(2012年2月2日 登録)

string get_day_link( mixed $year, mixed $month, mixed $day )
日アーカイブのURLを取得する。

remove_meta_box(2011年8月25日 登録)

void remove_meta_box( string $id, string $page, string $context )
投稿ページのメタボックスを削除(非表示)する。

term_exists(2011年6月2日 登録)

mixed term_exists( mixed $term [ , string $taxonomy = '' [ , int $parent = 0 ] ] )
タクソノミー情報が存在するか調べる。

user_can(2017年3月15日 登録)

bool user_can( mixed $user, string $capability )
ユーザの権限を調べる。

最終更新日時 : 2012-04-19 17:33