network_admin_url() WP 3.0.0

Retrieves the URL to the admin panel for the network — many sites management (not for a single blog of the network): /wp-admin/network.

If call this function on single site instalation (not Multisite) the admin_url() function will be called.

Return

String. Admin URL link with optional path appended.

Usage

network_admin_url( $path, $scheme );

$path(строка)

The path to a specific page of the admin. Will be added to the URL.
Default: ''

$scheme(строка)

The Protocol to be used. Can be:

• http
• https
• relative - returns a relative URL (without domain).

Function uses get_site_url(), therefore it also understands all its parameter values.

Default: 'admin', which obeys force_ssl_admin() and is_ssl()

Examples

#1 Get the URL to the admin area for the network

$url = network_admin_url();

/*
The result:

http://example.com/wp-admin/network/

Or if SSL is used:

https://example.com/wp-admin/network/
*/

#2 Get the URL to the specific page of the network admin area

This example demonstrates how to add a path and specify the protocol and what the function will return.

In this example we want to get the URL to the «Users - Add new» page, and specify the protocol (scheme) to https.

$url = network_admin_url( 'user-new.php', 'https' );
//> https://example.com/wp-admin/network/user-new.php

Changelog

Code of network_admin_url() network admin url ^{WP 5.7.2}

<?php
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
	 *
	 * @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.
	 */
	return apply_filters( 'network_admin_url', $url, $path );
}

Related Functions

From tag: Link (URL)

More from category: Multisite