W3cubDocs

/WordPress

wp_admin_bar_customize_menu( WP_Admin_Bar $wp_admin_bar )

Adds the “Customize” link to the Toolbar.

Parameters

$wp_admin_bar

(WP_Admin_Bar) (Required) WP_Admin_Bar instance.

Source

File: wp-includes/admin-bar.php 

function wp_admin_bar_customize_menu( $wp_admin_bar ) {
	global $wp_customize;

	// Don't show for users who can't access the customizer or when in the admin.
	if ( ! current_user_can( 'customize' ) || is_admin() ) {
		return;
	}

	// Don't show if the user cannot edit a given customize_changeset post currently being previewed.
	if ( is_customize_preview() && $wp_customize->changeset_post_id()
		&& ! current_user_can( get_post_type_object( 'customize_changeset' )->cap->edit_post, $wp_customize->changeset_post_id() )
	) {
		return;
	}

	$current_url = ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
	if ( is_customize_preview() && $wp_customize->changeset_uuid() ) {
		$current_url = remove_query_arg( 'customize_changeset_uuid', $current_url );
	}

	$customize_url = add_query_arg( 'url', urlencode( $current_url ), wp_customize_url() );
	if ( is_customize_preview() ) {
		$customize_url = add_query_arg( array( 'changeset_uuid' => $wp_customize->changeset_uuid() ), $customize_url );
	}

	$wp_admin_bar->add_node(
		array(
			'id'    => 'customize',
			'title' => __( 'Customize' ),
			'href'  => $customize_url,
			'meta'  => array(
				'class' => 'hide-if-no-customize',
			),
		)
	);
	add_action( 'wp_before_admin_bar_render', 'wp_customize_support_script' );
}

Uses

Uses Description
wp-includes/theme.php: is_customize_preview()

Whether the site is being previewed in the Customizer.
wp-includes/capabilities.php: current_user_can()

Returns whether the current user has the specified capability.
wp-includes/theme.php: wp_customize_url()

Returns a URL to load the Customizer.
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/load.php: is_admin()

Determines whether the current request is for an administrative interface page.
wp-includes/load.php: is_ssl()

Determines if SSL is used.
wp-includes/functions.php: remove_query_arg()

Removes an item or items from a query string.
wp-includes/functions.php: add_query_arg()

Retrieves a modified URL query string.
wp-includes/class-wp-admin-bar.php: WP_Admin_Bar::add_node()

Adds a node to the menu.
wp-includes/plugin.php: add_action()

Hooks a function on to a specific action.
wp-includes/post.php: get_post_type_object()

Retrieves a post type object by name.

Changelog

Version Description
4.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_admin_bar_customize_menu