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

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

Если вам нужен доступ к панели сети, используйте функцию network_admin_url().

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

Функция ADMIN_URL() используется внутри других функций, таких как:

• get_edit_term_link()
• get_edit_comment_link()
• wp_register()

Характеристики работы функции

• Время выполнения: 1 раз — 0.001915 сек (очень медленно), 50000 раз — 2.76 сек (быстро)
• Версия PHP: 7.1.2, WordPress: 4.7.4

У этой функции нет хуков.

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

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

Синтаксис функции

admin_url( $path, $scheme );

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

По умолчанию: 'admin'.

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

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

$url = admin_url();
echo $url; // выводит: http://example.com/wp-admin/

Протокол будет автоматически изменён при необходимости.

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

Например, если вам нужно перейти в раздел "Записи > Категории" с принудительным использованием протокола https:

$url = admin_url('edit-tags.php?taxonomy=category', 'https');
echo $url; // выводит: https://site.com/wp-admin/edit-tags.php?taxonomy=category

Изменения в функции

Функция была введена в версию 2.6.0 WordPress.

Код функции в WordPress 6.7.2

Код функции находится в файле wp-includes/link-template.php:

function admin_url( $path = '', $scheme = 'admin' ) {
    return get_admin_url( null, $path, $scheme );
}

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

Существует множество других функций, работающих с URL в WordPress:

• attachment_url_to_postid()
• comment_link()
• get_edit_post_link()
• home_url()
• network_admin_url()
• и многие другие...

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

Теперь вы знаете, как использовать функцию ADMIN_URL() и каки�� возможности она предоставляет в WordPress!