wp_admin_bar_render

函数


wp_admin_bar_render ( No parameters )
定义位置
  • wp-includes/admin-bar.php
    , line 74
引入
3.1.0
弃用

Renders the admin bar to the page based on the $wp_admin_bar->menu member var.

This is called very early on the {@see ‘wp_body_open’} action so that it will render
before anything else being added to the page body.

For backward compatibility with themes not using the ‘wp_body_open’ action,
the function is also called late on {@see ‘wp_footer’}.

It includes the {@see ‘admin_bar_menu’} action which should be used to hook in and
add new menus to the admin bar. That way you can be sure that you are adding at most
optimal point, right before the admin bar is rendered. This also gives you access to
the `$post` global, among others.

function wp_admin_bar_render() {
	global $wp_admin_bar;
	static $rendered = false;

	if ( $rendered ) {
		return;
	}

	if ( ! is_admin_bar_showing() || ! is_object( $wp_admin_bar ) ) {
		return;
	}

	/**
	 * Loads all necessary admin bar items.
	 *
	 * This is the hook used to add, remove, or manipulate admin bar items.
	 *
	 * @since 3.1.0
	 *
	 * @param WP_Admin_Bar $wp_admin_bar The WP_Admin_Bar instance, passed by reference.
	 */
	do_action_ref_array( 'admin_bar_menu', array( &$wp_admin_bar ) );

	/**
	 * Fires before the admin bar is rendered.
	 *
	 * @since 3.1.0
	 */
	do_action( 'wp_before_admin_bar_render' );

	$wp_admin_bar->render();

	/**
	 * Fires after the admin bar is rendered.
	 *
	 * @since 3.1.0
	 */
	do_action( 'wp_after_admin_bar_render' );

	$rendered = true;
}
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。