network_admin_url( string $path = '', string $scheme = 'admin' ): string
Retrieves the URL to the admin area for the network.
Contents
Parameters
-
$path
string Optional -
Optional path relative to the admin URL.
Default:
''
-
$scheme
string Optional -
The scheme to use. Default is
'admin'
, which obeys force_ssl_admin() and is_ssl() .'http'
or'https'
can be passed to force those schemes.Default:
'admin'
Return
string Admin URL link with optional path appended.
More Information
- The network_admin_url template tag retrieves the URL to the Network Admin area for the current site with the appropriate protocol, “https” if is_ssl() and “http” otherwise. If
$scheme
is “http” or “https”, is_ssl() is overridden. - If the site is not setup as multisite, admin_url() will be used instead.
Source
File: wp-includes/link-template.php
.
View all references
function network_admin_url( $path = '', $scheme = 'admin' ) {
if ( ! is_multisite() ) {
return admin_url( $path, $scheme );
}
$url = network_site_url( 'wp-admin/network/', $scheme );
if ( $path && is_string( $path ) ) {
$url .= ltrim( $path, '/' );
}
/**
* Filters the network admin URL.
*
* @since 3.0.0
* @since 5.8.0 The `$scheme` parameter was added.
*
* @param string $url The complete network admin URL including scheme and path.
* @param string $path Path relative to the network admin URL. Blank string if
* no path is specified.
* @param string|null $scheme The scheme to use. Accepts 'http', 'https',
* 'admin', or null. Default is 'admin', which obeys force_ssl_admin() and is_ssl().
*/
return apply_filters( 'network_admin_url', $url, $path, $scheme );
}
Hooks
-
apply_filters( 'network_admin_url',
string $url ,string $path ,string|null $scheme ) -
Filters the network admin URL.
Changelog
Version | Description |
---|---|
3.0.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Basic Example
Output:
http://www.example.com/wp-admin/network/
(protocol will be https when appropriate)
Output:
https://www.example.com/wp-admin/network/user-new.php