WordPress在后台顶部管理工具栏增加自定义菜单

WordPress后台顶部有一个便捷的管理工具栏，显示有站名、评论、新建等几个默认管理菜单，如果这几个管理菜单项不能满足站长的需求，站长也可以通过WordPress的钩子admin_bar_menu添加需求的自定义菜单，或者删除修改现有的管理菜单项。

钩子

do_action_ref_array( 'admin_bar_menu', WP_Admin_Bar $wp_admin_bar )

作用：加载所有必要的管理栏项目，这是用于添加，删除或修改管理栏项目的挂钩。

参数：

$wp_admin_bar – （WP_Admin_Bar）WP_Admin_Bar实例，通过引用传递

示例：

添加一个自定义菜单

function admin_bar_item ( WP_Admin_Bar $admin_bar ) {
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    $admin_bar->add_menu( array(
        'id'    => 'menu-id',
        'parent' => null,
        'group'  => null,
        'title' => '管理说明', //可以使用img引用图片代替文字.
        'href'  => admin_url('admin.php?page=custom-page'),//也可以直接使用超链接
        'meta' => [
            'title' => __( '管理说明', 'textdomain' ), //就是超链接的title
			'class' => 'my-manage' //添加一个样式
        ]
    ) );
}
add_action( 'admin_bar_menu', 'admin_bar_item', 500 );

PS：

源文件：wp-includes/admin-bar.php

WordPress官网文档：https://developer.wordpress.org/reference/hooks/admin_bar_menu/