wp_admin_bar_render

函式
wp_admin_bar_render ( No parameters )

wp_admin_bar_render: 這個函式用來渲染WordPress的管理欄: 當管理欄顯示時,它被WordPress自動呼叫。

根據$wp_admin_bar->選單成員var將管理欄渲染到頁面上。

這個動作在{@see ‘wp_body_open’}動作的早期被呼叫,所以它將在其他東西被新增到頁面主體之前渲染。

為了向後相容不使用’wp_body_open’動作的主題,該函式也在{@see ‘wp_footer’}的後期被呼叫。

它包括{@see ‘admin_bar_menu’}動作,應該用來鉤住並在管理欄中新增新的選單。這樣你就可以確定你是在最理想的位置新增的,就在管理欄被渲染之前。這也使你能夠訪問`$post’全域性,以及其他。

function wp_admin_bar_render() {
	global $wp_admin_bar;
	static $rendered = false;

	if ( $rendered ) {
		return;
	}

	if ( ! is_admin_bar_showing() || ! is_object( $wp_admin_bar ) ) {
		return;
	}

	/**
	 * Loads all necessary admin bar items.
	 *
	 * This is the hook used to add, remove, or manipulate admin bar items.
	 *
	 * @since 3.1.0
	 *
	 * @param WP_Admin_Bar $wp_admin_bar The WP_Admin_Bar instance, passed by reference.
	 */
	do_action_ref_array( 'admin_bar_menu', array( &$wp_admin_bar ) );

	/**
	 * Fires before the admin bar is rendered.
	 *
	 * @since 3.1.0
	 */
	do_action( 'wp_before_admin_bar_render' );

	$wp_admin_bar->render();

	/**
	 * Fires after the admin bar is rendered.
	 *
	 * @since 3.1.0
	 */
	do_action( 'wp_after_admin_bar_render' );

	$rendered = true;
}

常見問題

FAQs
檢視更多 >