wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_admin_bar_render › WordPress Function

Since3.1.0
Deprecatedn/a
› wp_admin_bar_render ( No parameters )
Defined at:
Codex:
Change Log:
  • 5.4.0

Renders the admin bar to the page based on the $wp_admin_bar->menu member var.

This is called very early on the {@see 'wp_body_open'} action so that it will render before anything else being added to the page body. For backward compatibility with themes not using the 'wp_body_open' action, the function is also called late on {@see 'wp_footer'}. It includes the {@see 'admin_bar_menu'} action which should be used to hook in and add new menus to the admin bar. This also gives you access to the $post global, among others.


Related Functions: wp_admin_bar_header, wp_admin_bar_wp_menu, _wp_admin_bar_init, wp_admin_bar_search_menu, wp_admin_headers

Source 

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 hook can add, remove, or manipulate admin bar items. The priority
	 * determines the placement for new items, and changes to existing items
	 * would require a high priority. To remove or manipulate existing nodes
	 * without a specific priority, use `wp_before_admin_bar_render`.
	 *
	 * @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;
}