Adds a group to a toolbar menu node.

Description

Groups can be used to organize toolbar items into distinct sections of a toolbar menu.

Parameters

$argsarrayrequired

Array of arguments for adding a group.

• id string
  ID of the item.
• parent string
  Optional. ID of the parent node. Default 'root'.
• meta array
  Meta data for the group including the following keys: 'class', 'onclick', 'target', and 'title'.

More Information

• 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.
• 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.
• The Toolbar replaces the Admin Bar since WordPress Version 3.3.

Source

final public function add_group( $args ) {
	$args['group'] = true;

	$this->add_node( $args );
}

View all references View on Trac View on GitHub

Changelog