Описание функции get_home_url()
Функция get_home_url() возвращает URL домашней страницы сайта, что позволяет разработчикам легко получить доступ к главной странице сайта. Функция может использоваться в темах и плагинах для создания ссылок на главную страницу.
URL формируется на основе настроек сайта и может учитывать префиксы, такие как HTTPS.
Параметры
$blog_id
Тип: int
Обязательный: Нет
По умолчанию: null
Описание: ID блога в мультисайтовой установке WordPress
Возможные значения:
type: положительное целое число или null
Возвращаемое значение
Тип: string
Описание: URL домашней страницы сайта
Возможные значения:
• URL типа ‘http://example.com’ или ‘https://example.com’
• Пустая строка или false при ошибке
Примеры использования
Базовый пример получения URL домашней страницы
$home_url = get_home_url();
// Вывод: http://example.com
В зависимости от настроек сайта вывод может быть разным
Получение URL для блога в мультисайтовой установке
$home_url = get_home_url(1);
// Вывод: http://example.com для блога с ID 1
ID блога может быть изменен
Безопасность
Валидация входных данных: ID блога проверяется на целочисленное значение
Санитизация: Функция автоматически обрабатывает данные
Рекомендации: Используйте esc_url() при выводе URL для предотвращения XSS
— Связанные функции
Синоним get_home_url(), используется для получения URL домашней страницы
Получает URL корневого каталога сайта
— Хуки
Фильтрует URL домашней страницы перед его возвратом
— Примечания
– Ограничения
Не подходит для получения URL страниц в контексте мультисайтов
– Частые проблемы
- Неверный URL при неправильных настройках сайта
- Проблемы с многосайтовыми установками без указания blog_id
