admin_url()

Функция admin_url() используется для организации бэкенда – работа по административной части WordPress – обновлена в WordPress 5.8

 

Получает URL админ-панели сайта. Учитывает протоколы (http и https).

 

Возможно организовать (получить) адрес конкретной страницы админки. Изменена в обновлении ядра Вордпресс 5.8.

 

 

 

 

 

 

 

 

 

 

 

 

функция admin_url

 

 

 

функция работает на основе: get_admin_url()

 

…и основа для таких: get_edit_term_link(), get_edit_comment_link(), wp_register()

 

 

Возвращает:

 

(строка) Ссылку (URL) на такую-то страницу админки.

 

 

используем:

 

admin_url( $path, $scheme );

 

 

$path

 

(строка) Путь до определенной страницы админпанели.

 

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

 

 

$scheme

 

(строка) Протокол который используется. Его возможно указать конкретно:

 

 

• http – указать протокол принудительно;
• https – указать протокол принудительно;
• relative – вернет относительный URL (без домена).

 

 

Данная функция использует get_site_url(), и поэтому принимает (понимает, считывает) все значения её параметра.

 

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

 

 

 

Примеры отработки функции:

 

 

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

 

 

$url = admin_url();
echo $url; // вернет: http://www.example.com/wp-admin/

 

 

 

пример 2:

 

 

Получаем (формируем) ссылку на конкретную страницу админки, например:

 

 

Посты/Категории

 

 

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

 

 

 

 

в качестве дополнения – фильтры функции:

 

 

 

apply_filters( 'admin_url', string $url, string $path, int|null $blog_id, string|null $scheme );

 

 

Фильтрует URL-адрес админки

 

 

Параметры:

 

$url

 

(строка) Полный URL-адрес административной области, включая схему и путь.

 

 

$path

 

(строка) Путь относительно URL-адреса админки. Пустая строка – если путь не указан.

 

$blog_id

 

(int | null) Идентификатор сайта или null для текущего сайта.

 

$scheme

 

(string | null) Используемая схема.

 

Принимает http, https, admin или null. По умолчанию ‘admin’, который подчиняется функциям force_ssl_admin () и is_ssl ().

 

 

 

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

 

 

$url = apply_filters( 'admin_url', $url, $path, $blog_id );

if ( !empty( $url ) ) {

// условия...

}

 

 

второй пример:

 

 

// define the admin_url callback = определяем обратный вызов admin_url
function filter_admin_url_my( $url, $path, $blog_id ) {
// что делаем...
return $url;
};

// add the filter
add_filter( 'admin_url', 'filter_admin_url_my', 10, 3 );

 

 

чтобы отключить фильтр, поступаем так:

 

 

 

// remove the filter
remove_filter( 'admin_url', 'filter_admin_url', 10, 3 );

 

 

 

 

В Ядре WordPress функция находится по адресу: wp-includes/link-template.php