WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

filter_SSL()

filter_SSL( string $url ): string

In this article

Back to top

Formats a URL to use https.

Description

Useful as a filter.

Parameters

$urlstringrequired
URL.

Return

string URL with https as the scheme.

Source

function filter_SSL( $url ) {  // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
	if ( ! is_string( $url ) ) {
		return get_bloginfo( 'url' ); // Return home site URL with proper scheme.
	}

	if ( force_ssl_content() && is_ssl() ) {
		$url = set_url_scheme( $url, 'https' );
	}

	return $url;
}

View all references View on Trac View on GitHub

UsesDescription
is_ssl()wp-includes/load.php

Determines if SSL is used.

set_url_scheme()wp-includes/link-template.php

Sets the scheme for a URL.

force_ssl_content()wp-includes/ms-functions.php

Determines whether to force SSL on content.

get_bloginfo()wp-includes/general-template.php

Retrieves information about the current site.

Show 1 moreShow less

Changelog

VersionDescription
2.8.5Introduced.

User Contributed Notes

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