WP_Admin_Bar::add_menu()
Додає елемент меню до адмін бару (тулбар розташований у верхній частині екрану на фронті).
Це аліас методу WP_Admin_Bar::add_node()
Використовувати цей метод потрібно на хуку admin_bar_menu .
Читайте також 11 хаків для Адмін-бару .
{} Це метод класу: WP_Admin_Bar{}
WP_Admin_Bar::add_node()
Хуків немає.
Повертає
null. Нічого.
Використання
$WP_Admin_Bar = новий WP_Admin_Bar(); $WP_Admin_Bar->add_node( $args );
-
$args
(масив) (обов’язковий) Аргументи елемента, що додається. Масив може містити такі ключі:
ID (рядок) (обов’язковий)
ID створюваного елемента панелі.title (рядок) (обов’язковий)
Заголовок/анкор посилання. Тут можна використовувати HTML теги, наприклад, щоб додати іконку.href (рядок) (обов’язковий)
УРЛ посилання.parent (рядок)
ID батьківського елемента, до якого елемент, що додається, повинен стати дочірнім.
Типово: falsegroup (логічний)
Чи є посилання груповим. Чи належить вона до якоїсь групи.
Типово: falsemeta (масив)
Додаткові посилання. Дод. атрибути тега 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 6.0.2
public function add_menu( $node ) {
$this->add_node( $node );
}