Changeset 13880

Timestamp:

03/29/2010 05:53:03 PM (16 years ago)

Author:

ryan

Message:

network_site_url(), network_home_url(), network_admin_url(). see #12736

File:

• trunk/wp-includes/link-template.php (modified) (1 diff)

trunk/wp-includes/link-template.php

@@ -2021 +2021 @@
 
 /**
+ * Retrieve the site url for the current network.
+ *
+ * Returns the site url with the appropriate protocol,  'https' if
+ * is_ssl() and 'http' otherwise. If $scheme is 'http' or 'https', is_ssl() is
+ * overridden.
+ *
+ * @package WordPress
+ * @since 3.0.0
+ *
+ * @param string $path Optional. Path relative to the site url.
+ * @param string $scheme Optional. Scheme to give the site url context. Currently 'http','https', 'login', 'login_post', or 'admin'.
+ * @return string Site url link with optional path appended.
+*/
+function network_site_url( $path = '', $scheme = null ) {
+        $orig_scheme = $scheme;
+        if ( !in_array($scheme, array('http', 'https')) ) {
+                if ( ( 'login_post' == $scheme || 'rpc' == $scheme ) && ( force_ssl_login() || force_ssl_admin() ) )
+                        $scheme = 'https';
+                elseif ( ('login' == $scheme) && ( force_ssl_admin() ) )
+                        $scheme = 'https';
+                elseif ( ('admin' == $scheme) && force_ssl_admin() )
+                        $scheme = 'https';
+                else
+                        $scheme = ( is_ssl() ? 'https' : 'http' );
+        }
+
+        $url = 'http://' . $current_site->domain . $current_site->path;
+
+        $url = str_replace( 'http://', "{$scheme}://", $url );
+
+        if ( !empty($path) && is_string($path) && strpos($path, '..') === false )
+                $url .= '/' . ltrim($path, '/');
+
+        return apply_filters('network_site_url', $url, $path, $orig_scheme);
+}
+
+/**
+ * Retrieve the home url for the current network.
+ *
+ * Returns the home url with the appropriate protocol,  'https' if
+ * is_ssl() and 'http' otherwise. If $scheme is 'http' or 'https', is_ssl() is
+ * overridden.
+ *
+ * @package WordPress
+ * @since 3.0.0
+ *
+ * @param  string $path   (optional) Path relative to the home url.
+ * @param  string $scheme (optional) Scheme to give the home url context. Currently 'http','https'
+ * @return string Home url link with optional path appended.
+*/
+function network_home_url( $path = '', $scheme = null ) {
+        $orig_scheme = $scheme;
+        $scheme      = is_ssl() && !is_admin() ? 'https' : 'http';
+
+        $url = 'http://' . $current_site->domain . $current_site->path;
+
+        $url = str_replace( 'http://', "$scheme://", $home );
+
+        if ( !empty( $path ) && is_string( $path ) && strpos( $path, '..' ) === false )
+                $url .= '/' . ltrim( $path, '/' );
+
+        return apply_filters( 'network_home_url', $url, $path, $orig_scheme);
+}
+
+/**
+ * Retrieve the url to the admin area for the network.
+ *
+ * @package WordPress
+ * @since 3.0.0
+ *
+ * @param string $path Optional path relative to the admin url
+ * @param string $scheme 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
+*/
+function network_admin_url( $path = '', $scheme = 'admin' ) {
+        $url = network_site_url($blog_id, 'wp-admin/', $scheme);
+
+        if ( !empty($path) && is_string($path) && strpos($path, '..') === false )
+                $url .= ltrim($path, '/');
+
+        return apply_filters('network_admin_url', $url, $path);
+}
+
+/**
  * Output rel=canonical for singular queries
  *