wp_admin_bar_render

（3.1.0以降）
wp_admin_bar_render - ツールバー（admin bar）をレンダリングする

説明

void wp_admin_bar_render()
ツールバー（admin bar）をレンダリングする。

パラメータ

パラメータはありません。

返り値

返り値はありません。

注意

テーマやプラグインから本関数を呼び出すことはないが、アクションを使用することでツールバーを変更できる。なお各アクションは、ツールバーの表示条件（ is_admin_bar_showing関数の返り値がtrueで、グローバル変数$wp_admin_barが（WP_Admin_Barクラスの）オブジェクト）を満たしている場合のみ実行される。

'admin_bar_menu'アクションを使用する場合、 add_action関数の第3パラメータの値によってツールバーの表示位置が変わる。

使用例

  • ツールバーにリンクを追加する。
    <?php
function admin_bar_my_link( $wp_admin_bar ) {
	$wp_admin_bar->add_menu( array(
		'id'    => 'ja-wp',
		'title' => 'ja.wp',
		'href'  => 'https://ja.wordpress.org/',
	) );
}

add_action( 'admin_bar_menu', 'admin_bar_my_link' ), 100 );
?>

フィルター

直接実行するフィルターはありません。

アクション

[3.1.0]ツールバーの表示条件を満たしている場合に'admin_bar_menu'アクションを呼び出す。パラメータにはグローバル変数$wp_admin_bar（のポインタ）が格納されている。 
do_action_ref_array( 'admin_bar_menu', array( &$wp_admin_bar ) );
[3.1.0]レンダリングの前に'wp_before_admin_bar_render'アクションを呼び出す。 
do_action( 'wp_before_admin_bar_render' );
[3.1.0]レンダリングの後に'wp_after_admin_bar_render'アクションを呼び出す。 
do_action( 'wp_after_admin_bar_render' );

ソースファイル

/wp-includes/admin-bar.php

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

関連

参考

Code Reference: wp_admin_bar_render

お勧め

ログアウト後はいつもサイトトップ（2018年5月27日 更新）

ログアウト後に表示（リダイレクト）されるページは、標準ではログインページ（wp-login.php）である。4.2.0ではログアウト処理後のページリダイレクト前に呼び出されるフィルターが追加された。

さくらのVPSでKUSANAGI#3（2018年5月27日 更新）

今回は「前回」の続き。http（80番）をクローズ、そのほかに行った調整作業について整理する。

oEmbed対応サイトを整理した（2017年11月18日 更新）

投稿記事にTwitterやYouTubeのURL（アドレス）を記述したとき、表示されるページにはリンクとしてではなく、埋め込んだURLの内容が表示される。この仕組み（機能）はoEmbedというもので、対応サイトは随時バージョンアップしている。

投稿内容に応じてwpautopを制御する（2013年8月13日 更新）

投稿内容を表示する the_content関数では、 wpautop関数がフィルターの1つとして呼び出され、改行をbrタグに変換したり、pタグで調整したりする。この機能自体は便利なのだが、きちんとデザインされたHTMLソースを流し込んだ場合はこの機能は好ましくない。そんなわけで、記事内容に応じてwpautop関数を制御できないか考えてみた。

Login rebuilder：プラグイン作ってみました（2019年9月7日 更新）

昨年投稿した「ログインページを変える」をプラグイン化。ログインページを独自の名前のページ変更し、標準のログインページwp-login.phpを使用できないようにするプラグインです。部外者によるwp-login.phpのアクセスにお悩みの方にお勧めします。また2.0.0では「XML-RPCリクエストの管理機能」を追加。2.2.0では管理者のログイン時にメールで通知する機能を追加しました。