WP_Admin_Bar::add_menu() WP 3.3.0

Добавляет элемент меню в админ бар (тулбар расположенный в верхней части экрана на фронте).

Ищем WP-разработчика! Фулл-тайм, удаленка, хорошая зарплата, соц. пакет. Подробности.
Компания Boosta.

Это алиас метода WP_Admin_Bar::add_node()

Использовать этот метод нужно на хуке admin_bar_menu.

Читайте также 11 хаков для Админ-бара.

{} Это метод класса: WP_Admin_Bar{}

Работает на основе: WP_Admin_Bar::add_node()

Хуков нет.

Возвращает

{{return_type}} Ничего.

Использование

$WP_Admin_Bar = new WP_Admin_Bar();
$WP_Admin_Bar->add_node( $args );

$args(массив) (обязательный)

Аргументы добавляемого элемента. Массив может содержать следующие ключи:

id(строка) (обязательный)
ID создаваемого элемента панели.
title(строка) (обязательный)
Заголовок/анкор ссылки. Тут можно использовать HTML теги, например чтобы добавить иконку.
href(строка) (обязательный)
УРЛ ссылки.
parent(строка)
ID родительского элемента, к которому подбавляемый элемент должен стать дочерним.
По умолчанию: false
group(логический)
Является ли ссылка групповой. Принадлежит ли она к какой-либо группе.
По умолчанию: false
meta(массив)
Дополнительные данные ссылки. Доп. атрибуты тега A. Может быть:
- html - любой HTML код или просто текст, который будет выведен сразу после тега A.
- class - атрибут 'class'
- rel - атрибут 'rel'
- onclick - атрибут 'onclick'
- target - как открывать ссылку '_blank' - в новом окне
- title - атрибут title
- tabindex - порядок при нажатии на клавишу TAB
По умолчанию: array()

Примеры

#1 Добавим ссылку и дочернюю ссылку в панель

// Добавляет ссылку в админ бар
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',
		'title' => 'Внешняя ссылка',
		'href'  => 'http://example.com',
	) );

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

В результате получим:

Чтобы изменить положение всего блока ссылок, пункта (поставить его до или после какого-то блока), измените число 30 — чем больше, тем ближе к концу.

#2 Дочерняя ссылка в меню сайта на страницу плагинов

// дочерняя ссылка в меню сайта на страницу плагинов
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'),
		) );
	}, 100 );
}

Список изменений

С версии 3.3.0

Введена.

Код `WP_Admin_Bar::add_menu() WP Admin Bar::add menu` ^{WP 5.8.1}

wp-includes/class-wp-admin-bar.php

public function add_menu( $node ) {
	$this->add_node( $node );
}