General: Document the difference between site_url() and home_url().

`site_url()` returns a url where WordPress application files are accessible (e.g. where the `wp-admin/` folder resides). `home_url()` returns a url where the front-end of the WordPress site can be visited.

See #35238.

Built from https://develop.svn.wordpress.org/trunk@36408


git-svn-id: http://core.svn.wordpress.org/trunk@36375 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Eric Lewis 2016-01-27 02:55:27 +00:00
parent c7923b2c9d
commit 2d2353cbde
2 changed files with 7 additions and 5 deletions

View File

@ -2925,7 +2925,7 @@ function get_shortcut_link() {
} }
/** /**
* Retrieve the home url for the current site. * Retrieve the url for the current site where the front-end of the site is accessible.
* *
* Returns the 'home' option with the appropriate protocol, 'https' if * Returns the 'home' option with the appropriate protocol, 'https' if
* {@see is_ssl()} and 'http' otherwise. If `$scheme` is 'http' or 'https', * {@see is_ssl()} and 'http' otherwise. If `$scheme` is 'http' or 'https',
@ -2943,7 +2943,7 @@ function home_url( $path = '', $scheme = null ) {
} }
/** /**
* Retrieve the home url for a given site. * Retrieve the url for a given site where the front-end of the site is accessible.
* *
* Returns the 'home' option with the appropriate protocol, 'https' if * Returns the 'home' option with the appropriate protocol, 'https' if
* {@see is_ssl()} and 'http' otherwise. If `$scheme` is 'http' or 'https', * {@see is_ssl()} and 'http' otherwise. If `$scheme` is 'http' or 'https',
@ -3000,7 +3000,8 @@ function get_home_url( $blog_id = null, $path = '', $scheme = null ) {
} }
/** /**
* Retrieve the site url for the current site. * Retrieve the url for the current site where WordPress application files
* (e.g. wp-blog-header.php or the wp-admin/ folder) are accessible.
* *
* Returns the 'site_url' option with the appropriate protocol, 'https' if * Returns the 'site_url' option with the appropriate protocol, 'https' if
* is_ssl() and 'http' otherwise. If $scheme is 'http' or 'https', is_ssl() is * is_ssl() and 'http' otherwise. If $scheme is 'http' or 'https', is_ssl() is
@ -3017,7 +3018,8 @@ function site_url( $path = '', $scheme = null ) {
} }
/** /**
* Retrieve the site url for a given site. * Retrieve the url for a given site where WordPress application files
* (e.g. wp-blog-header.php or the wp-admin/ folder) are accessible.
* *
* Returns the 'site_url' option with the appropriate protocol, 'https' if * Returns the 'site_url' option with the appropriate protocol, 'https' if
* {@see is_ssl()} and 'http' otherwise. If `$scheme` is 'http' or 'https', * {@see is_ssl()} and 'http' otherwise. If `$scheme` is 'http' or 'https',

View File

@ -4,7 +4,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '4.5-alpha-36407'; $wp_version = '4.5-alpha-36408';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.