do_action_ref_array( ‘admin_bar_menu’, WP_Admin_Bar $wp_admin_bar )

User Contributed Notes

1. Skip to note 6 content

   iqbalrony 5 years ago

   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

   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
   		]
   	) );
   }

   • The priority of core menu items can be found in WP_Admin_Bar::add_menus(). You can decide where you’d like to hook in your specific menu item by setting a specific priority.

     Tanner Record 7 months ago
2. Skip to note 7 content

   Niloy 3 years ago

   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

   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 8 content

   Eric Hepperle 1 year ago

   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

   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 9 content

   Lance Cleveland 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: -6You must log in to vote on the helpfulness of this note

   Find the order that hooks and filters are called here: https://codex.wordpress.org/Plugin_API/Action_Reference
5. Skip to note 10 content

   Akhtarujjaman Shuvo 3 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: -6You must log in to vote on the helpfulness of this note

   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'),
       ) );
   
   }

   • When this code is added to a Code Snippet this error appears and breaks the editor area of the dashboard: Fatal error: Uncaught TypeError: call_user_func_array(): Argument #1 ($callback) must be a valid callback, function “admin_bar_item” not found or invalid function name in T:\csite_30_elijahStreams\_dev\wp-includes\class-wp-hook.php on line 310 ( ! ) TypeError: call_user_func_array(): Argument #1 ($callback) must be a valid callback, function “admin_bar_item” not found or invalid function name in T:\csite_30_elijahStreams\_dev\wp-includes\class-wp-hook.php on line 310

     Eric Hepperle 1 year ago