WP_Customize_Manager::get_allowed_urls(): array

In this article

Gets URLs allowed to be previewed.

Description

If the front end and the admin are served from the same domain, load the preview over ssl if the Customizer is being loaded over ssl. This avoids insecure content warnings. This is not attempted if the admin and front end are on different domains to avoid the case where the front end doesn’t have ssl certs. Domain mapping plugins can allow other urls in these conditions using the customize_allowed_urls filter.

Return

array Allowed URLs.

Source

public function get_allowed_urls() {
	$allowed_urls = array( home_url( '/' ) );

	if ( is_ssl() && ! $this->is_cross_domain() ) {
		$allowed_urls[] = home_url( '/', 'https' );
	}

	/**
	 * Filters the list of URLs allowed to be clicked and followed in the Customizer preview.
	 *
	 * @since 3.4.0
	 *
	 * @param string[] $allowed_urls An array of allowed URLs.
	 */
	$allowed_urls = array_unique( apply_filters( 'customize_allowed_urls', $allowed_urls ) );

	return $allowed_urls;
}

Hooks

apply_filters( ‘customize_allowed_urls’, string[] $allowed_urls )

Filters the list of URLs allowed to be clicked and followed in the Customizer preview.

Changelog

VersionDescription
4.7.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.