get_home_url()
Получает URL главной страницы сайта (без / на конце). Можно указать ID сайта сети. Учитывает протокол (http,https).
Основа для функции home_url().
Возвращает значение опции get_option('home')
с правильным протоколом. Протокол будет:
https
— когда выполняется условие is_ssl().http
— в других случаях.
Протокол можно форсированно переписать, указав третий параметр $scheme
.
Константа WP_HOME
.
В wp-config.php можно указать константу WP_HOME, тогда эта функция будет получать значение этой константы, а не значение из БД.
Используйте эту функцию только, когда нужно получить URL сайта, а не URL WordPress (где лежат файлы ядра) (см. Общие настройки WordPress). Для получения URL WordPress, используйте get_site_url().
Хуки из функции
Возвращает
Строку
. Строку, УРЛ на главную страницу блога.
Использование
get_home_url( $blog_id, $path, $scheme );
- $blog_id(число)
- ID блога, УРЛ которого надо получить.
По умолчанию: null (текущий блог) - $path(строка)
- Путь до главной страницы блога. Строка которая будет дописана к УРЛу блога (
/qwe
).
По умолчанию: '' - $scheme(строка)
- Схема в которой нужно возвращать УРЛ. Может быть:
http
,https
,relative
.
По умолчанию: null
Примеры
#1 Выведем УРЛ блога
<?php echo get_home_url(); ?>
http://example.com
<?php echo get_home_url( null, 'wp-admin/', 'https' ); ?>
https://example.com/wp-admin/
#2 Демо
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
Список изменений
С версии 3.0.0 | Введена. |