Функция network_home_url() возвращает домашний URL главного сайта текущей сети, поддерживая возможность указания протокола. Эта функция полезна для мультисайтовых установок WordPress, где требуется построить URL для всего ресурса.
network_home_url( string $path = '', string|null $scheme = null ): string
Параметры:
$path(string) — путь, добавляемый к домашнему URL. По умолчанию:''.$scheme(string|null) — протокол URL. Может принимать значения'http','https'или'relative'. По умолчаниюnull, что приводит к автоматическому выбору протокола на основе настроек безопасности.
Возвращаемое значение:
string— URL домашней страницы главного сайта сети, с добавленным путем, если он указан.
Когда использовать network_home_url()
Эта функция полезна для ссылок на главный сайт сети, чтобы обеспечить корректные переходы между сайтами, созданными в рамках одной сети, или единый доступ к страницам, доступным на уровне всей сети.
Пример 1. Получение базового URL главного сайта сети
Самый простой способ использования — вызов network_home_url() без параметров. Это вернет основной URL главного сайта.
// Выводит URL главной страницы сети
echo network_home_url();
// Пример вывода: http://www.networkexample.com
Пример 2. Добавление пути к URL сети
Чтобы построить ссылку на конкретный раздел главного сайта сети, можно передать путь в параметре $path. Это может быть полезно для доступа к общим ресурсам на уровне сети.
// Создаем ссылку на страницу "О нас" главного сайта сети
$about_url = network_home_url( 'about' );
echo $about_url;
// Пример вывода: http://www.networkexample.com/about
Пример 3. Принудительная установка протокола HTTP
Если сайт работает по протоколу HTTPS, но требуется сформировать ссылку с HTTP, используйте $scheme со значением 'http'. Это может быть полезно для старых страниц или ресурсов, работающих по протоколу HTTP.
// Создаем ссылку на главную страницу с использованием HTTP
$http_url = network_home_url( '', 'http' );
echo $http_url;
// Пример вывода: http://www.networkexample.com
Пример 4. Принудительная установка протокола HTTPS
Чтобы обеспечить доступ к странице через HTTPS, можно использовать $scheme со значением 'https'. Это актуально, когда требуется защищенное соединение для определенного раздела сети.
// Создаем защищенную ссылку на раздел "Контакты"
$secure_contact_url = network_home_url( 'contact', 'https' );
echo $secure_contact_url;
// Пример вывода: https://www.networkexample.com/contact
Пример 5. Относительный URL
В некоторых случаях может понадобиться получить относительный путь. Для этого $scheme можно установить в значение 'relative'.
// Получаем относительный URL для страницы новостей
$relative_news_url = network_home_url( 'news', 'relative' );
echo $relative_news_url;
// Пример вывода: /news
Заключение
Функция network_home_url() — это удобный инструмент для работы с мультисайтовыми сетями WordPress, который позволяет гибко строить ссылки с различными протоколами и добавляемыми путями.