Функция NETWORK_ADMIN_URL() в WordPress

Функция NETWORK_ADMIN_URL() предназначена для получения ссылки н�� административную панель сети в WordPress, которая используется для управления несколькими сайтами (это не относится к одному сайту в сети). Путь к административной панели сети выглядит так: /wp-admin/network.

Если вы вызовете эту функцию на установке WordPress без мультисайтовой функции, то будет вызвана функция admin_url().

Использование функции

Синтаксис

network_admin_url( $path, $scheme );

• $path (строка): Путь к конкретной странице админки. Этот путь будет добавлен к URL.

  • По умолчанию: '' (пустая строка)

• $scheme (строка): Протокол, который будет использован. Может быть:

  • http
  • https
  • relative — возвращает относительный URL (без домена).

По умолчанию используется значение 'admin', которое зависит от функции force_ssl_admin() и проверки на SSL (is_ssl()).

Примеры использования

Пример 1: Получение URL админки сети

$url = network_admin_url();

Результат:

• Если используется обычный HTTP:

  http://example.com/wp-admin/network/

• Если используется SSL:

  https://example.com/wp-admin/network/

Пример 2: Получение URL конкретной страницы админки сети

Допустим, вы хотите получить URL страницы "Пользователи - Добавить нового" и указать, что нужно использовать протокол HTTPS.

$url = network_admin_url( 'user-new.php', 'https' );
// Результат: https://example.com/wp-admin/network/user-new.php

Возврат значения

Функция возвращает строку. Это будет ссылка на админп panel с добавленным (если нужно) путем.

Код функции

Вот как реализована функция network_admin_url в WordPress:

function network_admin_url( $path = '', $scheme = 'admin' ) {
if ( ! is_multisite() ) {
return admin_url( $path, $scheme );
}

$url = network_site_url( 'wp-admin/network/', $scheme );

if ( $path && is_string( $path ) ) {
    $url .= ltrim( $path, '/' );
}

return apply_filters( 'network_admin_url', $url, $path, $scheme );

}

Примечания

• Эта функция доступна начиная с версии 3.0.0 WordPress.
• С версии 5.8.0 был добавлен параметр $scheme.

Связанные функции

• admin_url()
• attachment_url_to_postid()
• site_url()

Эти функции также помогают управлять URL-адресами в WordPress, и вы можете использовать их в зависимости от ваших нужд.

Заключение

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