$wp_admin_bar 是 WordPress 中的一个对象参数，传递给 admin_bar_menu 钩子函数，用于操作和管理后台工具栏（Admin Bar）的内容。
它是 WP_Admin_Bar 类的一个实例，提供了一些方法来添加、删除、修改工具栏上的菜单项和子菜单项。
常用方法
add_node()
用于添加新的菜单项或子菜单项。
$wp_admin_bar->add_node( array(
‘id’ => ‘menu_item_id’, // 菜单项的唯一ID
‘title’ => ‘Menu Item Title’, // 显示的标题
‘href’ => ‘URL’, // 链接地址
‘parent’ => ‘parent_node_id’, // 可选：指定父菜单项的ID
‘meta’ => array( ‘target’ => ‘_blank’ ) // 可选：设置链接的属性，如 target=”_blank”
));
remove_node()
用于删除工具栏中的指定菜单项。
$wp_admin_bar->remove_node( ‘menu_item_id’ );
get_node()
获取某个菜单项的详细信息。
$node = $wp_admin_bar->get_node( ‘menu_item_id’ );
get_nodes()
获取工具栏中所有菜单项的节点信息。
$nodes = $wp_admin_bar->get_nodes();
add_group()
为菜单项添加一个分组，以便在显示时进行分组管理。
$wp_admin_bar->add_group( array(
‘id’ => ‘group_id’, // 分组的唯一ID
‘title’ => ‘Group Title’, // 分组的标题
));
示例
自定义后台工具栏
function custom_admin_bar_menu($wp_admin_bar) {
// 添加顶级菜单项
$wp_admin_bar->add_node(array(
‘id’ => ‘my_custom_menu’,
‘title’ => ‘My Custom Menu’,
‘href’ => ‘#’,
));
// 添加子菜单项
$wp_admin_bar->add_node(array(
‘id’ => ‘my_custom_submenu’,
‘parent’ => ‘my_custom_menu’, // 指定父菜单项
‘title’ => ‘Sub Menu Item’,
‘href’ => ‘#’,
));
// 添加带图标的菜单项
$wp_admin_bar->add_node(array(
‘id’ => ‘my_icon_menu’,
‘title’ => ‘Menu with Icon’,
‘href’ => ‘#’,
‘meta’ => array(
‘class’ => ‘my-custom-icon-class’, // 添加自定义样式
),
));
}
add_action(‘admin_bar_menu’, ‘custom_admin_bar_menu’, 100);