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

Determines whether to force SSL used for the Administration Screens.

Contents

Parameters

$force string|bool Optional
Whether to force SSL in admin screens.

Default: null

Top ↑

Return

bool True if forced, false if not forced.

Top ↑

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.

Top ↑

Source

File: wp-includes/functions.php. View all references 

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

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

	return $forced;
}

View on Trac View on GitHub

Top ↑

Top ↑

Used By

Used By
Used By Description
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.

Top ↑

Changelog

Changelog
Version Description
2.6.0 Introduced.

Top ↑

User Contributed Notes

  2. Skip to note 2 content
    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
    Contributed by Codex —

    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.