wp_admin_bar_add_secondary_groups()
云策文档标注
概述
wp_admin_bar_add_secondary_groups() 函数用于向 WordPress 管理工具栏添加次级菜单组。它通过 WP_Admin_Bar 实例调用 add_group() 方法,定义了两个次级组,以支持工具栏的布局和样式定制。
关键要点
- 函数接受一个必需参数:$wp_admin_bar,即 WP_Admin_Bar 实例。
- 内部调用 $wp_admin_bar->add_group() 两次,分别添加 'top-secondary' 和 'wp-logo-external' 两个组。
- 这些组通过 'meta' 数组设置 CSS 类,如 'ab-top-secondary' 和 'ab-sub-secondary',用于前端样式控制。
- 函数自 WordPress 3.3.0 版本引入,相关方法为 WP_Admin_Bar::add_group()。
代码示例
function wp_admin_bar_add_secondary_groups( $wp_admin_bar ) {
$wp_admin_bar->add_group(
array(
'id' => 'top-secondary',
'meta' => array(
'class' => 'ab-top-secondary',
),
)
);
$wp_admin_bar->add_group(
array(
'parent' => 'wp-logo',
'id' => 'wp-logo-external',
'meta' => array(
'class' => 'ab-sub-secondary',
),
)
);
}
原文内容
Adds secondary menus.
Parameters
$wp_admin_barWP_Admin_Barrequired-
The WP_Admin_Bar instance.
Source
function wp_admin_bar_add_secondary_groups( $wp_admin_bar ) {
$wp_admin_bar->add_group(
array(
'id' => 'top-secondary',
'meta' => array(
'class' => 'ab-top-secondary',
),
)
);
$wp_admin_bar->add_group(
array(
'parent' => 'wp-logo',
'id' => 'wp-logo-external',
'meta' => array(
'class' => 'ab-sub-secondary',
),
)
);
}
Changelog
| Version | Description |
|---|---|
| 3.3.0 | Introduced. |