WordPress.org

Description

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.

Usage

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

Parameters

$args

(array) (required) An array of arguments.

Default: None

Arguments

id

(string) (required) The ID of the group (node).

Default: false

parent

(string) (optional) The ID of the parent node.

Default: false

meta

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

Default: array()

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

Examples

Adding a group to a parent node

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

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 first group
	$args = array(
		'id'     => 'another_group_child_node2',
		'title'  => 'another group child node2',
		'parent' => 'first_grouped_node',
	);
	$wp_admin_bar->add_node( $args );


}

The output from this example in the toolbar will be:

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

Change Log

Source File

add_group() is located in wp-includes/class-wp-admin-bar.php.

Related

Toolbar API

• Article: The WordPress Toolbar
• Class: WP_Admin_Bar
• Function: add_node()
• Function: remove_node()
• Function: add_menu()
• Function: remove_menu()
• Function: add_group()
• Function: get_node()
• Function: get_nodes()