This function adds a new group to the Toolbar. Groups allow you to group Toolbar items together into distinct sections of a toolbar menu.

The Toolbar replaces the Admin Bar since WordPress Version 3.3.

Toolbar items are also called "nodes". Nodes can be parents for other nodes, which creates dropdown menus. When adding a group you're actually adding a group node. Group nodes are not visible in the Toolbar, but nodes added to it are.

note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks.

add_group() 描述


<?php $wp_admin_bar->add_group$args ); ?>

add_group() 用法



(array) (必填) An array of arguments.

默认值: None



(string) (必填) The ID of the group (node).

默认值: false


(string) (可选) The ID of the parent node.

默认值: false


(array) (可选) An array of meta data for the group (node).

默认值: array()

  • 'class' - The class attribute for the unordered list containing the child nodes.

add_group() 参数


Adding a group to a parent node

This example adds a parent node, child nodes and a group to the toolbar.

/* ----------------------------------
 * wordpress之魂 ©
 * ---------------------------------- */

add_action( 'admin_bar_menu', 'add_nodes_and_groups_to_toolbar', 999 );

function add_nodes_and_groups_to_toolbar( $wp_admin_bar ) {

	// add a parent item
	$args = array(
		'id'    => 'parent_node',
		'title' => 'parent node'
	$wp_admin_bar->add_node( $args );

	// add a child item to our parent item
	$args = array(
		'id'     => 'child_node',
		'title'  => 'child node',
		'parent' => 'parent_node'
	$wp_admin_bar->add_node( $args );

	// add a group node with a class "first-toolbar-group"
	$args = array(
		'id'     => 'first_group',
		'parent' => 'parent_node',
		'meta'   => array( 'class' => 'first-toolbar-group' )
	$wp_admin_bar->add_group( $args );

	// add an item to our group item
	$args = array(
		'id'     => 'first_grouped_node',
		'title'  => 'first group node',
		'parent' => 'first_group'
	$wp_admin_bar->add_node( $args );

	// add another child item to our parent item (not to our first group)
	$args = array(
		'id'     => 'another_child_node',
		'title'  => 'another child node',
		'parent' => 'parent_node'
	$wp_admin_bar->add_node( $args );


The output from this example in the toolbar will be:

/* ----------------------------------
 * wordpress之魂 ©
 * ---------------------------------- */

 * parent node
 ** child node
 ** another child node
 ** first group node

add_group() 示例


add_group() 函数的代码位于 wp-includes/class-wp-admin-bar.php.

add_group() 源文件