wp_admin_bar_render() — описание функции WordPress на русском

Сигнатура

wp_admin_bar_render()

Описание

Вызывается очень рано на действии «wp_body_open», чтобы отрисоваться раньше всего остального, добавляемого в тело страницы.
Для обратной совместимости с темами, не использующими действие «wp_body_open», функция также вызывается поздно на «wp_footer».
Она включает действие «admin_bar_menu», которое следует использовать для привязки и добавления новых меню в панель администратора. Помимо прочего, это также даёт доступ к глобальной переменной $post.

Оригинал (английский)

This is called very early on the ‘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 ‘wp_footer’.

It includes the ‘admin_bar_menu’ action which should be used to hook in and add new menus to the admin bar. This also gives you access to the $post global, among others.

Исходный код

wp-includes/admin-bar.php:73

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 hook can add, remove, or manipulate admin bar items. The priority
	 * determines the placement for new items, and changes to existing items
	 * would require a high priority. To remove or manipulate existing nodes
	 * without a specific priority, use `wp_before_admin_bar_render`.
	 *
	 * @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;
}

История изменений

Версия	Описание
5.4.0	Called on 'wp_body_open' action first, with 'wp_footer' as a fallback.
3.1.0	Introduced.