wp_admin_bar_render

パラメータ

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

返り値

返り値はありません。

注意

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

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

[5.4.0]'wp_body_open'アクションで呼び出されるようになった（'wp_body_open'アクションを使用しないテーマでは従来通り'wp_footer'アクションで呼び出される）。

使用例

• ツールバーにリンクを追加する。

  <?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 );
  ?>

フィルター

アクション

do_action_ref_array( 'admin_bar_menu', array( &$wp_admin_bar ) );

do_action( 'wp_before_admin_bar_render' );

do_action( 'wp_after_admin_bar_render' );

ソースファイル