WordPress.org

Description

The network_site_url template tag retrieves the site url for the "main" site of the current network 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, site_url() will be used instead.

Usage

<?php network_site_url( $path, $scheme ); ?>

Default Usage

<?php echo network_site_url(); ?>

Parameters

$path

(string) (optional) Path to be appended to the site url.

Default: None

$scheme

(string) (optional) Context for the protocol for the url returned. Setting $scheme will override the default context. Allowed values are 'http', 'https', 'login', 'login_post', or 'admin'.

Default: null

Return

(string) 

Site url link with optional path appended.

Examples

// Get the current site's URL
$url = network_site_url();
echo $url;

Output: http://www.example.com/wordpress/

// Get a secure URL for a specific page within the current site
$url = network_site_url('/contact-us/', 'https');
echo $url;

Output: https://www.example.com/contact-us/

Notes

• Uses is_multisite()
• Uses force_ssl_login()
• Uses force_ssl_admin()
• Uses is_ssl()
• Uses site_url() for single site installations
• Uses $current_site global variable
• This function will not perform URL encoding on any passed path - you will need to do that yourself.

Changelog

• Since: 2.6.0

Source Code

network_site_url() is located in wp-includes/link-template.php.

Related