向工具栏加入一组自定义链接
描述
此函数将一个新组添加到工具栏。组允许您将工具栏项组合到工具栏菜单的不同部分中。
工具栏取代了自WordPress版本3.3以来的管理栏。
工具栏项也称为“节点”。节点可以是其他节点的父节点，这会创建下拉菜单。添加组时，实际上是在添加组节点。组节点在工具栏中不可见，但添加到工具栏的节点可见。
注意：此函数是 WP_Admin_Bar 类和 $wp_admin_bar 全局对象的方法，除了在 'admin_bar_menu' 或 'wp_before_admin_bar_render' 钩子期间，它可能不存在。
用法
<?php $wp_admin_bar->add_group( $args ); ?>参数
$args
(array) (必填) 参数数组。
默认值: None
Arguments
id
(string) (必填) 组（节点）的 ID。
默认值: false
parent
(string) (可选) 父节点的 ID。
默认值: false
meta
(array) (可选) 组（节点）的元数据数组。
默认值: array()
‘class’ – 包含子节点的无序列表的类属性。
示例
将组添加到父节点
此示例将父节点、子节点和组添加到工具栏。
/* ———————————-
* wordpress函数 XingkongWEB.com收集
* ———————————- */
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 );
}工具栏中此示例的输出将是：
/* ———————————-
* wordpress函数 星空站长网收集
* ———————————- */
* parent node
** child node
** another child node
** first group node源文件
add_group() 函数的代码位于 wp-includes/class-wp-admin-bar.php.
