do_action_ref_array( 'admin_bar_menu', WP_Admin_Bar $wp_admin_bar )

Loads all necessary admin bar items.

Contents

Description

This is the hook used to add, remove, or manipulate admin bar items.

Top ↑

Parameters

$wp_admin_bar WP_Admin_Bar
The WP_Admin_Bar instance, passed by reference.

Top ↑

Source

File: wp-includes/admin-bar.php. View all references 

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

View on Trac View on GitHub

Top ↑

Top ↑

Changelog

Changelog
Version Description
3.1.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 8You must log in to vote on the helpfulness of this note
    Contributed by iqbalrony —

    This hook is used to add the admin bar menu.

    Example:-

    add_action( 'admin_bar_menu', 'admin_bar_item', 500 );
function admin_bar_item ( WP_Admin_Bar $admin_bar ) {
	if ( ! current_user_can( 'manage_options' ) ) {
		return;
	}
	$admin_bar->add_menu( array(
		'id'    => 'menu-id',
		'parent' => null,
		'group'  => null,
		'title' => 'Menu Title', //you can use img tag with image link. it will show the image icon Instead of the title.
		'href'  => admin_url('admin.php?page=custom-page'),
		'meta' => [
			'title' => __( 'Menu Title', 'textdomain' ), //This title will show on hover
		]
	) );
}
  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note
    Contributed by Niloy —

    Display custom menu only for the admin area and add dropdown menu

    function ci_admin_bar_item( WP_Admin_Bar $wp_admin_bar ) {

	if ( !is_admin() ) {
		return;
	} // Display Menu only for wp-admin area

	$menu_id = 'new-order-notify';

	$wp_admin_bar->add_menu(
		array(
			'id'     => $menu_id,
			'parent' => null , // use 'top-secondary' for toggle menu position.
			'href'   => admin_url( 'admin.php?page=custom-page-slug' ),
			'title'  => __( 'New Order Notification', 'text-domain' ),
		)
	);
	$wp_admin_bar->add_menu(
		array(
			'parent' => $menu_id,
			'title'  => __( 'Disable', 'text-domain'  ),
			'id'     => 'new-order-notification-disable',
			'href'   => admin_url( 'admin.php?page=custom-submenu-slug' ),

		)
	);

}
add_action( 'admin_bar_menu', 'ci_admin_bar_item', 100 );
  3. Skip to note 3 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Eric Hepperle —

    Add date and time to right side of the admin bar near the “Howdy” and avatar section

    I researched all day to figure out how to do this and wanted to share a working example to help save others some time and frustration.

    CAVEAT: This code is tested and verified it works as of Sept 2023. However, WordPress is always changing, so it is possible if you are reading this in ten years it may not be valid anymore.

    • $parent_slug : this is an id you make up. It should be self explanatory, in this case adminbar-date-time
    • top-secondary : tells WP to put this node / link / text on the right side
    • the 500 in add_action() : means keep it on the leftmost of that rightmost section
    • $local_time : uses the WP API current_time() function to grab the time and date for the timezone registered in Settings > General
    • $title : This the text that actually displays in the admin bar. Can be text, variables, and HTML. Here we calculate the date and time first as $local_time and the result of that variable is what will display in the admin bar. If we wanted we could do 'title' => __( 4 * 8 ), and 32 is what would be shown in the admin bar.
    • href : If you are making this a hyperlink then put the destination URL here. In this example, options-general.php is the Settings > General page so you can change time and date if you want
    add_action( 'admin_bar_menu', 'wpdocs_add_date_time_adminbar_right', 500 );
function wpdocs_add_date_time_adminbar_right( WP_Admin_Bar $wp_admin_bar ) {
    $parent_slug = 'adminbar-date-time';
    $local_time  = date( 'Y-m-d, g:i a', current_time( 'timestamp', 0 ) );

    $wp_admin_bar->add_menu( array(
        'id'     => $parent_slug,
        'parent' => 'top-secondary',
        'group'  => null,
        'title'  => $local_time,
        'href'   => admin_url( '/options-general.php' ),
    ) );
}
  4. Skip to note 4 content
    You must log in to vote on the helpfulness of this noteVote results for this note: -5You must log in to vote on the helpfulness of this note
    Contributed by Akhtarujjaman Shuvo —

    This is how you can add admin bar menus to the right side.

    add_action( 'admin_bar_menu', 'admin_bar_item', 500 );
function admin_bar_menus( WP_Admin_Bar $wp_admin_bar ) {

    $parent_slug = 'license-manager-wppt';

    $wp_admin_bar->add_menu( array(
        'id'    => $parent_slug,
        'parent' => 'top-secondary',
        'group'  => null,
        'title' => __( 'License Manager', 'lmfwppt' ),
        'href'  => admin_url('admin.php?page=license-manager-wppt'),
    ) );

}

You must log in before being able to contribute a note or feedback.