Функция GET_ADMIN_URL() в WordPress: синтаксис, примеры использования, код.

# Функция GET_ADMIN_URL() в WordPress

Функция get_admin_url() позволяет получить URL-адрес админ-панели вашего сайта на WordPress. Она имеет дополнительный параметр $blog_id, который полезен при использовании мультисайтовой установки WordPress.

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

Функция get_admin_url() работает аналогично функции admin_url(), но является более универсальной благодаря дополнительным параметрам.

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

Функция возвращает строку — ссылку на админ-URL с добавленным параметром пути, если он указан.

### Синтаксис

```php
get_admin_url( $blog_id, $path, $scheme );

• $blog_id (int) — ID блога (сайта). По умолчанию: null (текущий сайт).
• $path (string) — Путь, относительный к URL админ-панели. По умолчанию: ''.
• $scheme (string) — Протокол, который нужно использовать. Возможные значения:
  • http
  • https
  • relative — возвращает относительный URL (без домена).
  • login — протокол страницы входа.
  • login_post — протокол для поста входа.
  • admin
  • rest
  • rpc
  • null — использует текущий протокол сайта, определяемый функцией is_ssl().

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

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

Пример 1: Основное использование

$url = get_admin_url();
echo $url; 
// Вывод: http://www.example.com/wp-admin/

В этом примере функция возвращает URL админ-панели, автоматически заменяя протокол на https, если ваш сайт его поддерживает.

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

echo get_admin_url(null, 'edit-tags.php?taxonomy=category', 'https'); 
// Вывод: https://www.example.com/wp-admin/edit-tags.php?taxonomy=category

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

Пример 3: Получение ссылки на определённый блог (например, блог с ID 2)

$url = get_admin_url(2);
echo $url; 
// Вывод: https://www.blog2.example.com/wp-admin/

В этом примере мы получаем ссылку на админ-панель блога с ID 2.

Код функции

function get_admin_url( $blog_id = null, $path = '', $scheme = 'admin' ) {
    $url = get_site_url( $blog_id, 'wp-admin/', $scheme );

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

    return apply_filters( 'admin_url', $url, $path, $blog_id, $scheme );
}

Функция get_admin_url() использует функцию get_site_url() для получения базового адреса админ-панели. Затем она добавляет к URL относительный путь, если он указан.

Примечание

Фильтрация apply_filters( 'admin_url', ...) позволяет разработчикам изменять URL админ-панели на ваш вкус.

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

• add_menu_page() — добавление страницы в меню админ-панели.
• get_current_screen() — получение текущего экрана админ-панели.
• is_admin() — проверка, находитесь ли вы в админ-панели.

Эти функции могут быть полезны, если вы разрабатываете собственные плагины или настройки для WordPress.