Функция network_admin_url() в WordPress: получение URL административной панели для сети

Функция network_admin_url() предназначена для мультисайтовых установок WordPress. Она формирует URL, который ведет к административной панели управления сетью. Это удобно, если требуется доступ к специфическим разделам панели сети, особенно при создании ссылок для пользователей с правами администратора сети.

network_admin_url( string $path = '', string $scheme = 'admin' ): string

Параметры:

• $path (string) — путь, добавляемый к URL панели администратора сети. По умолчанию: ''.
• $scheme (string) — схема URL, которая может принимать значения: 'admin', 'http', 'https' или 'relative'. По умолчанию 'admin', что автоматически определяет протокол в зависимости от настройки SSL.

Возвращаемое значение:

• string — URL к административной панели сети, с учетом переданного пути и схемы.

Примечание: Если мультисайт не активирован, то вместо network_admin_url() будет автоматически использована функция admin_url(), создающая URL для стандартной административной панели.

Пример 1. Получение основного URL административной панели сети

Этот пример показывает, как получить URL, ведущий в корень панели управления сетью.

// URL к панели управления сетью
echo network_admin_url();

// Пример вывода: http://example.com/wp-admin/network/

Пример 2. Добавление пути к определенной странице админки сети

Вы можете использовать $path, чтобы указать путь к конкретной странице внутри панели управления сетью, например, к странице добавления нового пользователя.

// URL для страницы "Добавить пользователя" в панели сети
$user_add_url = network_admin_url( 'user-new.php' );

echo $user_add_url;

// Пример вывода: http://example.com/wp-admin/network/user-new.php

Пример 3. Принудительное использование HTTPS для ссылки

Для обеспечения защищенного соединения можно принудительно установить протокол HTTPS, передав 'https' в качестве значения параметра $scheme. Это особенно полезно, если сайт поддерживает SSL.

// Ссылка на страницу добавления пользователя через защищенное соединение
$secure_user_add_url = network_admin_url( 'user-new.php', 'https' );

echo $secure_user_add_url;

// Пример вывода: https://example.com/wp-admin/network/user-new.php

Пример 4. Получение относительного URL

Если требуется получить относительный URL без доменного имени, можно указать 'relative' в параметре $scheme.

// Относительный URL к странице добавления нового пользователя в сети
$relative_user_add_url = network_admin_url( 'user-new.php', 'relative' );

echo $relative_user_add_url;

// Пример вывода: /wp-admin/network/user-new.php

Заключение

Функция network_admin_url() — это мощный инструмент для построения ссылок на административные страницы в мультисайтовых сетях WordPress. Она позволяет гибко настраивать URL, добавляя необходимые параметры и протоколы, что делает её особенно полезной для разработки и настройки административной панели сети.