wppaste
WordPress

WP_Customize_Manager::get_return_url(): string

Since
4.4.0
Source
wp-includes/class-wp-customize-manager.php:4718
Gets URL to link the user to when closing the Customizer.

Return

string
URL for link to close Customizer.

Uses · 4

  • wp_get_referer()Retrieves referer from '_wp_http_referer' or HTTP referer.
  • wp_basename()i18n-friendly version of basename().
  • admin_url()Retrieves the URL to the admin area for the current site.
  • home_url()Retrieves the URL for the current site where the front end is accessible.

Used by · 1

Source

	public function get_return_url() {		global $_registered_pages; 		$referer                    = wp_get_referer();		$excluded_referer_basenames = array( 'customize.php', 'wp-login.php' ); 		if ( $this->return_url ) {			$return_url = $this->return_url; 			$return_url_basename = wp_basename( parse_url( $this->return_url, PHP_URL_PATH ) );			$return_url_query    = parse_url( $this->return_url, PHP_URL_QUERY ); 			if ( 'themes.php' === $return_url_basename && $return_url_query ) {				parse_str( $return_url_query, $query_vars ); 				/*				 * If the return URL is a page added by a theme to the Appearance menu via add_submenu_page(),				 * verify that it belongs to the active theme, otherwise fall back to the Themes screen.				 */				if ( isset( $query_vars['page'] ) && ! isset( $_registered_pages[ "appearance_page_{$query_vars['page']}" ] ) ) {					$return_url = admin_url( 'themes.php' );				}			}		} elseif ( $referer && ! in_array( wp_basename( parse_url( $referer, PHP_URL_PATH ) ), $excluded_referer_basenames, true ) ) {			$return_url = $referer;		} elseif ( $this->preview_url ) {			$return_url = $this->preview_url;		} else {			$return_url = home_url( '/' );		} 		return $return_url;	}

History

Introduced in 4.4.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/class-wp-customize-manager.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.