函数文档

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.