この記事は最後に更新してから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


お勧め

get_userdata(2022年2月4日 更新)

mixed get_userdata( int $user_id )
ユーザIDを指定し、マッチするユーザ情報を取得する。

has_filter(2022年11月8日 更新)

mixed has_filter( $tag, [ mixed $function_to_check = false ] )
WordPressタグにフィルターが登録されているか調べる。

wp_add_object_terms(2013年8月6日 更新)

mixed wp_add_object_terms( int $object_id, mixed $terms, mixed $taxonomy )
投稿情報などにタクソノミーを追加する。

is_tag(2018年5月27日 更新)

bool is_tag( [ mixed $slug = '' ] )
要求されているページが、タグアーカイブページか調べる。

add_meta_box(2014年11月16日 更新)

void add_meta_box( string $id, string $title, string $callback, string $page [, string $context = 'advanced' [, string $priority = 'default' [, array $callback_args = null ] ] ] )
投稿ページに独自のメタボックスを表示する。