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'

Top ↑

Return

string Admin URL link with optional path appended.

Top ↑

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.

Top ↑

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

View on Trac View on GitHub

Top ↑

Hooks

Top ↑

Top ↑

Used By

Used By
Used By Description
WP_Site_Health::get_test_plugin_version() wp-admin/includes/class-wp-site-health.php

Tests if plugins are outdated, or unnecessary.
WP_Customize_Manager::handle_load_themes_request() wp-includes/class-wp-customize-manager.php

Loads themes into the theme browsing/installation UI.
update_network_option_new_admin_email() wp-includes/ms-functions.php

Sends a confirmation request email when a change of network admin email address is attempted.
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_ajax_search_install_plugins() wp-admin/includes/ajax-actions.php

Handles searching plugins to install via AJAX.
wp_ajax_search_plugins() wp-admin/includes/ajax-actions.php

Handles searching plugins via AJAX.
wp_ajax_install_theme() wp-admin/includes/ajax-actions.php

Handles installing a theme via AJAX.
wp_ajax_install_plugin() wp-admin/includes/ajax-actions.php

Handles installing a plugin via AJAX.
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_Automatic_Updater::send_email() wp-admin/includes/class-wp-automatic-updater.php

Sends an email upon the completion or failure of a background core update.
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_network_dashboard_right_now() wp-admin/includes/dashboard.php
WP_Plugin_Install_List_Table::display_rows() wp-admin/includes/class-wp-plugin-install-list-table.php
WP_Themes_List_Table::no_items() wp-admin/includes/class-wp-themes-list-table.php
wp_ajax_query_themes() wp-admin/includes/ajax-actions.php

Handles getting themes from themes_api() via AJAX.
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.
wp_admin_bar_site_menu() wp-includes/admin-bar.php

Adds the “Site Name” menu.
wp_admin_bar_my_sites_menu() wp-includes/admin-bar.php

Adds the “My Sites/[Site Name]” menu and all submenus.
wp_admin_bar_updates_menu() wp-includes/admin-bar.php

Provides an update link if theme/plugin/core updates are available.
newblog_notify_siteadmin() wp-includes/ms-functions.php

Notifies the network admin that a new site has been activated.
newuser_notify_siteadmin() wp-includes/ms-functions.php

Notifies the network admin that a new user has been activated.
Show 27 more used by Hide more used by

Top ↑

Changelog

Changelog
Version Description
3.0.0 Introduced.

Top ↑

User Contributed Notes

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

    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

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