WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

force_ssl_admin()

force_ssl_admin( string|bool|null $force = null ): bool

In this article

Back to top

Determines whether to force SSL used for the Administration Screens.

Parameters

$forcestring|bool|nulloptional
Whether to force SSL in admin screens.

Default:null

Return

bool True if forced, false if not forced.

More Information

Determine whether the administration panel should be viewed over SSL. This function relies on the FORCE_SSL_ADMIN constant that is set in the wp-config.php file if you’re using your site over SSL.

The force parameter will change the return value of this function until it is reset.

Source

function force_ssl_admin( $force = null ) {
	static $forced = false;

	if ( ! is_null( $force ) ) {
		$old_forced = $forced;
		$forced     = (bool) $force;
		return $old_forced;
	}

	return $forced;
}

View all references View on Trac View on GitHub

Used byDescription
get_rest_url()wp-includes/rest-api.php

Retrieves the URL to a REST endpoint on a site.

auth_redirect()wp-includes/pluggable.php

Checks if a user is logged in, if not it redirects them to the login page.

force_ssl_login()wp-includes/deprecated.php

Whether SSL login should be forced.

wp_ssl_constants()wp-includes/default-constants.php

Defines SSL-related WordPress constants.

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

Sets the scheme for a URL.

Changelog

VersionDescription
2.6.0Introduced.

User Contributed Notes

  2. Skip to note 5 content
    Codex
    You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note

    Changing the Return Value

    <?php
force_ssl_admin(true);
if ( force_ssl_admin() ) {
  echo 'Administration should be performed over SSL';
} else {
  echo 'This code will never execute';
}
force_ssl_admin(false);
if ( force_ssl_admin() ) {
  echo 'This code will never execute';
} else {
  echo 'Administration should NOT be performed over SSL';
}
?>

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