home_url()
Получает УРЛ главной страницы сайта (без слэша / на конце). Учитывает протокол (http,https).
Возвращает значение опции get_option('home') с правильным протоколом. Протокол будет:
https— когда выполняется условие is_ssl().http— в других случаях.
Протокол можно форсированно переписать, указав второй параметр $scheme.
Используйте эту функцию, когда нужно получить URL сайта (фронта), а не URL WordPress (админки) (см. Общие настройки).
Используйте site_url(), когда нужно получить URL WordPress (админка, где лежат файлы).
Константа WP_HOME - в wp-config.php можно указать константу WP_HOME, тогда эта функция будет получать значение этой константы, а не значение из БД.
Для мультисайта. Используйте get_home_url( $blog_id ), когда нужно получить ссылку на другой сайт в сети сайтов, а не URL адрес текущего сайта.
Хуков нет.
Возвращает
Строку. URL адрес сайта.
Использование
home_url( $path, $scheme );
- $path(строка)
- Путь, который будет вставлен в конец ссылки.
По умолчанию: '' - $scheme(строка)
- Протокол УРЛ. По умолчанию вычисляется через is_ssl(). Может быть:
http,https,relative.
По умолчанию: null
Примеры
#1 Примеры получения адреса сайта:
echo home_url(); // http://example.com echo home_url( '/' ); // http://example.com/ echo home_url( 'blog', 'relative' ); // /blog echo home_url( 'blog' ); // https://example.com/blog echo home_url( '/blog', 'https' ); // https://example.com/blog echo home_url( '#hash', 'https' ); // https://example.com/#hash echo home_url( '//foo.bar/foo' ); // http://example.com/foo.bar/foo echo home_url( 'http://foo.bar/foo' ); // http://example.com/http://foo.bar/foo echo home_url( '/mypage?id=123' ); // https://example.com/mypage?id=123
#2 Пример использования в шаблоне (в теме)
Функция получает значение, а не выводит его на экран, чтобы вывести значение на экран используйте echo:
<a href="<?php echo home_url(); ?>">Домой</a>
Или можно сокращенно:
<a href="<?= home_url() ?>">Домой</a>
Список изменений
| С версии 3.0.0 | Введена. |
Код home_url() home url WP 6.6.2
function home_url( $path = '', $scheme = null ) {
return get_home_url( null, $path, $scheme );
}