Добавление ссылок в панель администратора WordPress

# Добавление элементов (ссылок) в панель администратора (toolbar)

Чтобы добавить ссылки в панель администратора WordPress, используйте метод WP_Admin_Bar::add_menu(), который также известен как WP_Admin_Bar::add_node(). Добавление ссылок должно происходить через хук admin_bar_menu.

## Как добавить ссылки в панель

Вы можете добавить как верхний уровень ссылок, так и дочерние ссылки. Например, давайте добавим одну ссылку и дочернюю ссылку в панель:

// Добавляет ссылку в панель администратора
add_action( 'admin_bar_menu', 'my_admin_bar_menu', 30 );

function my_admin_bar_menu( $wp_admin_bar ) {
    $wp_admin_bar->add_menu( array(
        'id'    => 'menu_id',               // Уникальный ID для вашей ссылки
        'title' => 'Внешняя ссылка',        // Текст, который будет отображаться
        'href'  => 'http://example.com',     // URL, на который ведёт ссылка
    ) );

    // дочерняя ссылка
    $wp_admin_bar->add_menu( array(
        'parent' => 'menu_id',               // ID родительской ссылки
        'id'     => 'some_id',               // Уникальный ID для дочерней ссылки
        'title'  => 'Дочерняя ссылка',       // Текст дочерней ссылки
        'href'   => 'http://example.com/subpage', // URL дочерней ссылки
    ) );
}

### Иltегирование элементов
В результате, вы получите следующую структуру в панели администратора:
![Пример панели администратора](https://example.com/image) 
Чтобы изменить положение всего блока ссылок (например, переместить его перед или после определённого блока), измените число 30. Чем больше число, тем ближе ваш элемент будет к концу панели.
## Пример: Дочерняя ссылка в меню сайта для страницы плагинов
Вот ещё один пример, как добавить дочернюю ссылку в меню сайта для страницы плагинов:
// Дочерняя ссылка в меню сайта для страницы плагинов
if( ! is_admin() ){
    add_action( 'admin_bar_menu', function ( $wp_admin_bar ) {
        $wp_admin_bar->add_menu( array(
            'parent' => 'site-name',           // ID родительского элемента
            'id'     => 'plugins_link',        // Уникальный ID для дочерней ссылки
            'title'  => 'Плагины',             // Текст дочерней ссылки
            'href'   => admin_url('plugins.php'), // URL для страницы плагинов
        ) );
    }, 100 );
}

Обратите внимание на полный список всех возможных параметров, которые вы можете использовать с WP_Admin_Bar::add_menu(), чтобы настроить ссылки в панели под свои нужды.
---
Надеюсь, эта статья поможет вам лучше понять, как добавлять ссылки в панель администратора WordPress!