get_home_url()
Gets the URL of the site's main page (without / at the end). You can specify the site ID of the network. Considers the protocol (http, https).
The basis for the function home_url().
Returns the value of the option get_option('home')
with the correct protocol. The protocol will be:
https
— when the condition is_ssl() is met.http
— in other cases.
The protocol can be forcibly rewritten by specifying the third parameter $scheme
.
Constant WP_HOME
.
In wp-config.php, you can specify the constant WP_HOME, then this function will get the value of this constant instead of the value from the database.
Use this function only when you need to get the site URL, not the WordPress URL (where the core files are located) (see General Settings in WordPress). To get the WordPress URL, use get_site_url().
Hooks from the function
Returns
String
. String, URL to the blog's main page.
Usage
get_home_url( $blog_id, $path, $scheme );
- $blog_id(int|null)
- ID of the blog whose URL needs to be obtained.
Default: null (current blog) - $path(string)
- Path to the blog's main page. A string that will be appended to the blog's URL (
/qwe
).
Default: '' - $scheme(string)
- The scheme in which to return the URL. Can be:
http
,https
,relative
.
Default: null
Examples
#1 Let's display the blog's URL
<?php echo get_home_url(); ?>
http://example.com
<?php echo get_home_url( null, 'wp-admin/', 'https' ); ?>
https://example.com/wp-admin/
#2 Demo
echo get_home_url(); // http://example.com echo get_home_url( null, '/' ); // http://example.com/ echo get_home_url( null, 'blog', 'relative' ); // /blog echo get_home_url( null, 'blog' ); // https://example.com/blog echo get_home_url( null, '/blog', 'https' ); // https://example.com/blog echo get_home_url( null, '#hash', 'https' ); // https://example.com/#hash echo get_home_url( null, '//foo.bar/foo' ); // http://example.com/foo.bar/foo echo get_home_url( null, 'http://foo.bar/foo' ); // http://example.com/http://foo.bar/foo echo get_home_url( null, '/mypage?id=123' ); // https://example.com/mypage?id=123
Changelog
Since 3.0.0 | Introduced. |