network_admin_url()

💡 云策文档标注

概述

network_admin_url() 函数用于获取当前站点网络管理区域的 URL，支持多站点环境。如果站点未启用多站点，则回退到 admin_url()。

关键要点

函数返回网络管理区域的 URL，可附加可选路径。
参数 $path 为可选相对路径，默认为空字符串。
参数 $scheme 控制协议，默认为 'admin'，自动根据 force_ssl_admin() 和 is_ssl() 决定；可指定 'http' 或 'https' 强制覆盖。
在非多站点环境中，自动调用 admin_url() 替代。
提供 'network_admin_url' 过滤器，允许自定义 URL。

代码示例

$url = network_admin_url();
echo $url;
// 输出示例: http://www.example.com/wp-admin/network/

$url = network_admin_url( 'user-new.php', 'https' );
echo $url;
// 输出示例: https://www.example.com/wp-admin/network/user-new.php

📄 原文内容

Retrieves the URL to the admin area for the network.

Parameters

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

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
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.
admin_url()`wp-includes/link-template.php`	Retrieves the URL to the admin area for the current site.
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.
WP_Site_Health::get_test_plugin_version()`wp-admin/includes/class-wp-site-health.php`	Tests if plugins are outdated, or unnecessary.
validate_plugin_requirements()`wp-admin/includes/plugin.php`	Validates the plugin requirements for WordPress version and PHP version.
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_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_new_content_menu()`wp-includes/admin-bar.php`	Adds “Add New” menu.
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 33 more Show less

Changelog

Version	Description
3.0.0	Introduced.

User Contributed Notes

Skip to note 2 content

Codex

10 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

云策 WordPress 开发者社区

函数文档

network_admin_url()

概述

关键要点

代码示例

Parameters

Return

More Information

Source

Hooks

Changelog

User Contributed Notes