network_admin_url() – Function | Developer.WordPress.org

Retrieves the URL to the admin area for the network.

Parameters

$pathstringoptional: Optional path relative to the admin URL.
Default:''
$schemestringoptional: 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

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 );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘network_admin_url’, string $url, string $path, string|null $scheme ): Filters the network admin URL.

Uses	Description
admin_url()`wp-includes/link-template.php`	Retrieves the URL to the admin area for the current site.
network_site_url()`wp-includes/link-template.php`	Retrieves the site URL for the current network.
is_multisite()`wp-includes/load.php`	Determines whether Multisite is enabled.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 2 more Show less

Used by	Description
WP_Plugin_Dependencies::check_plugin_dependencies_during_ajax()`wp-includes/class-wp-plugin-dependencies.php`	Checks plugin dependencies after a plugin is installed via AJAX.
WP_Plugin_Dependencies::display_admin_notice_for_unmet_dependencies()`wp-includes/class-wp-plugin-dependencies.php`	Displays an admin notice if dependencies are not installed.
WP_Plugin_Install_List_Table::get_more_details_link()`wp-admin/includes/class-wp-plugin-install-list-table.php`	Creates a ‘More details’ link for the plugin.
wp_get_plugin_action_button()`wp-admin/includes/plugin-install.php`	Gets the markup for the plugin install action button.
WP_Plugins_List_Table::get_view_details_link()`wp-admin/includes/class-wp-plugins-list-table.php`	Returns a ‘View details’ link for the plugin.
validate_plugin_requirements()`wp-admin/includes/plugin.php`	Validates the plugin requirements for WordPress version and PHP version.
get_site_screen_help_tab_args()`wp-admin/includes/ms.php`	Returns the arguments for the help tab on the Edit Site screens.
network_edit_site_nav()`wp-admin/includes/ms.php`	Outputs the HTML for a network’s “Edit Site” tabular interface.
WP_MS_Sites_List_Table::handle_row_actions()`wp-admin/includes/class-wp-ms-sites-list-table.php`	Generates and displays row action links.
WP_MS_Sites_List_Table::column_blogname()`wp-admin/includes/class-wp-ms-sites-list-table.php`	Handles the site name column output.
WP_MS_Sites_List_Table::column_users()`wp-admin/includes/class-wp-ms-sites-list-table.php`	Handles the users column output.
WP_MS_Users_List_Table::handle_row_actions()`wp-admin/includes/class-wp-ms-users-list-table.php`	Generates and displays row action links.
WP_MS_Users_List_Table::column_blogs()`wp-admin/includes/class-wp-ms-users-list-table.php`	Handles the sites column output.
WP_MS_Users_List_Table::get_views()`wp-admin/includes/class-wp-ms-users-list-table.php`
WP_Plugins_List_Table::single_row()`wp-admin/includes/class-wp-plugins-list-table.php`
site_admin_notice()`wp-admin/includes/ms.php`	Displays an admin notice to upgrade all sites after a core upgrade.
core_update_footer()`wp-admin/includes/update.php`	Returns core update footer message.
update_nag()`wp-admin/includes/update.php`	Returns core update notification message.
update_right_now_message()`wp-admin/includes/update.php`	Displays WordPress version and active theme in the ‘At a Glance’ dashboard widget.
WP_Themes_List_Table::no_items()`wp-admin/includes/class-wp-themes-list-table.php`
self_admin_url()`wp-includes/link-template.php`	Retrieves the URL to the admin area for either the current site or the network depending on context.
get_edit_profile_url()`wp-includes/link-template.php`	Retrieves the URL to the user’s profile editor.

Show 17 more Show less

Changelog

Version	Description
3.0.0	Introduced.

User Contributed Notes

Skip to note 2 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Basic Example
```
$url = network_admin_url();
echo $url;
```
Output: http://www.example.com/wp-admin/network/

(protocol will be https when appropriate)
```
// generate url path to Users -> Add New page in the admin and force https
$url = network_admin_url( 'user-new.php', 'https' );
echo $url;
```
Output: https://www.example.com/wp-admin/network/user-new.php
Log in to add feedback

network_admin_url( string $path = '', string $scheme = 'admin' ): string

In this article

Parameters

Return

More Information

Source

Hooks

Changelog

User Contributed Notes