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

Retrieves the URL to the admin area for the network.

Contents

Description Description

Parameters Parameters

$path

(string) (Optional) path relative to the admin URL.

Default value: ''

$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 value: 'admin'

Top ↑

Return Return

(string) Admin URL link with optional path appended.

Top ↑

Source Source

File: wp-includes/link-template.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 );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
3.0.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/load.php: is_multisite()

If Multisite is enabled.
wp-includes/link-template.php: admin_url()

Retrieves the URL to the admin area for the current site.
wp-includes/link-template.php: network_site_url()

Retrieves the site URL for the current network.
wp-includes/link-template.php: network_admin_url

Filters the network admin URL.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.

Top ↑

Used By Used By

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

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

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

Send a confirmation request email when a change of network admin email address is attempted.
wp-admin/includes/ms.php: get_site_screen_help_tab_args()

Returns the arguments for the help tab on the Edit Site screens.
wp-admin/includes/ms.php: network_edit_site_nav()

Outputs the HTML for a network’s “Edit Site” tabular interface.
wp-admin/includes/ajax-actions.php: wp_ajax_search_install_plugins()

Ajax handler for searching plugins to install.
wp-admin/includes/ajax-actions.php: wp_ajax_search_plugins()

Ajax handler for searching plugins.
wp-admin/includes/ajax-actions.php: wp_ajax_install_theme()

Ajax handler for installing a theme.
wp-admin/includes/ajax-actions.php: wp_ajax_install_plugin()

Ajax handler for installing a plugin.
wp-admin/includes/class-wp-ms-sites-list-table.php: WP_MS_Sites_List_Table::handle_row_actions()

Generates and displays row action links.
wp-admin/includes/class-wp-ms-sites-list-table.php: WP_MS_Sites_List_Table::column_blogname()

Handles the site name column output.
wp-admin/includes/class-wp-ms-sites-list-table.php: WP_MS_Sites_List_Table::column_users()

Handles the users column output.
wp-admin/includes/class-wp-ms-users-list-table.php: WP_MS_Users_List_Table::handle_row_actions()

Generates and displays row action links.
wp-admin/includes/class-wp-ms-users-list-table.php: WP_MS_Users_List_Table::column_blogs()

Handles the sites column output.
wp-admin/includes/class-wp-automatic-updater.php: WP_Automatic_Updater::send_email()

Sends an email upon the completion or failure of a background core update.
wp-admin/includes/class-wp-ms-users-list-table.php: WP_MS_Users_List_Table::get_views()
wp-admin/includes/class-wp-plugins-list-table.php: WP_Plugins_List_Table::single_row()
wp-admin/includes/ms.php: site_admin_notice()

Displays an admin notice to upgrade all sites after a core upgrade.
wp-admin/includes/update.php: core_update_footer()
wp-admin/includes/update.php: update_nag()
wp-admin/includes/update.php: update_right_now_message()
wp-admin/includes/dashboard.php: wp_network_dashboard_right_now()
wp-admin/includes/class-wp-plugin-install-list-table.php: WP_Plugin_Install_List_Table::display_rows()
wp-admin/includes/class-wp-themes-list-table.php: WP_Themes_List_Table::no_items()
wp-admin/includes/ajax-actions.php: wp_ajax_query_themes()

Ajax handler for getting themes from themes_api().
wp-admin/includes/bookmark.php: wp_link_manager_disabled_message()

Outputs the ‘disabled’ message for the WordPress Link Manager.
wp-includes/link-template.php: self_admin_url()

Retrieves the URL to the admin area for either the current site or the network depending on context.
wp-includes/link-template.php: get_edit_profile_url()

Retrieves the URL to the user’s profile editor.
wp-includes/admin-bar.php: wp_admin_bar_site_menu()

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

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

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

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

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

Top ↑

User Contributed Notes 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.