WP_Admin_Bar::add_menu() WP 3.3.0
Добавляет элемент меню в админ бар (тулбар расположенный в верхней части экрана на фронте).
Это алиас метода WP_Admin_Bar::add_node()
{} Это метод класса: WP_Admin_Bar{}
Хуков нет.
Возвращает
Null. Ничего.
Использование
$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
- атрибут titletabindex
- порядок при нажатии на клавишу 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.6.2
public function add_menu( $node ) {
$this->add_node( $node );
}