admin_url

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

Изменение URL административной области сайта

/**
 * Фильтрует URL административной области.
 *
 * @param string      $url      Полный URL административной области, включая схему и путь.
 * @param string      $path     Путь относительно URL административной области. Пустая строка, если путь не указан.
 * @param int|null    $blog_id  Идентификатор сайта или null для текущего сайта.
 * @param string|null $scheme   Схема, используемая для URL. Принимает значения 'http', 'https', 'admin' или null.
 *                              По умолчанию 'admin', что соответствует force_ssl_admin() и is_ssl().
 * @return string Измененный URL административной области.
 */
function custom_admin_url( $url, $path, $blog_id, $scheme ) {
    // Добавляем к URL административной области дополнительный путь
    $new_path = '/custom-path' . $path;
    $new_url  = str_replace( $path, $new_path, $url );
    return $new_url;
}
add_filter( 'admin_url', 'custom_admin_url', 10, 4 );

В данном примере мы используем хук admin_url для изменения URL административной области сайта. Функция custom_admin_url принимает четыре параметра: $url — полный URL административной области, $path — путь относительно URL административной области, $blog_id — идентификатор сайта или null для текущего сайта, $scheme — схема, используемая для URL.

В данном примере мы добавляем к URL административной области дополнительный путь «/custom-path». Для этого мы используем функцию str_replace, которая заменяет оригинальный путь на новый путь. Затем измененный URL возвращается из функции.

Перенаправление на другую страницу административной области

/**
 * Фильтрует URL административной области для перенаправления на другую страницу.
 *
 * @param string      $url      Полный URL административной области, включая схему и путь.
 * @param string      $path     Путь относительно URL административной области. Пустая строка, если путь не указан.
 * @param int|null    $blog_id  Идентификатор сайта или null для текущего сайта.
 * @param string|null $scheme   Схема, используемая для URL. Принимает значения 'http', 'https', 'admin' или null.
 *                              По умолчанию 'admin', что соответствует force_ssl_admin() и is_ssl().
 * @return string Измененный URL административной области для перенаправления.
 */
function redirect_admin_url( $url, $path, $blog_id, $scheme ) {
    // Перенаправляем на страницу "Настройки"
    $redirect_url = $url . 'options-general.php';
    return $redirect_url;
}
add_filter( 'admin_url', 'redirect_admin_url', 10, 4 );

В данном примере мы используем хук admin_url для перенаправления на другую страницу административной области. Функция redirect_admin_url принимает четыре параметра: $url — полный URL административной области, $path — путь относительно URL административной области, $blog_id — идентификатор сайта или null для текущего сайта, $scheme — схема, используемая для URL.

В данном примере мы перенаправляем на страницу «Настройки» путем добавления к URL административной области дополнительного пути «options-general.php». Измененный URL возвращается из функции и используется для перенаправления.

Добавление параметров к URL административной области

/**
 * Фильтрует URL административной области для добавления параметров.
 *
 * @param string      $url      Полный URL административной области, включая схему и путь.
 * @param string      $path     Путь относительно URL административной области. Пустая строка, если путь не указан.
 * @param int|null    $blog_id  Идентификатор сайта или null для текущего сайта.
 * @param string|null $scheme   Схема, используемая для URL. Принимает значения 'http', 'https', 'admin' или null.
 *                              По умолчанию 'admin', что соответствует force_ssl_admin() и is_ssl().
 * @return string Измененный URL административной области с добавленными параметрами.
 */
function add_query_args_admin_url( $url, $path, $blog_id, $scheme ) {
    // Добавляем параметры к URL административной области
    $new_url = add_query_arg( array(
        'param1' => 'value1',
        'param2' => 'value2',
    ), $url );
    return $new_url;
}
add_filter( 'admin_url', 'add_query_args_admin_url', 10, 4 );

В данном примере мы используем хук admin_url для добавления параметров к URL административной области. Функция add_query_args_admin_url принимает четыре параметра: $url — полный URL административной области, $path — путь относительно URL административной области, $blog_id — идентификатор сайта или null для текущего сайта, $scheme — схема, используемая для URL.

В данном примере мы используем функцию add_query_arg для добавления параметров к URL административной области. Массив параметров передается в качестве первого аргумента функции, а оригинальный URL — вторым аргументом. Функция возвращает измененный URL с добавленными параметрами.

Получение URL административной области для конкретного сайта

/**
 * Получает URL административной области для конкретного сайта.
 *
 * @param int|null    $blog_id  Идентификатор сайта или null для текущего сайта.
 * @param string|null $path     Путь относительно URL административной области. Пустая строка, если путь не указан.
 * @param string|null $scheme   Схема, используемая для URL. Принимает значения 'http', 'https', 'admin' или null.
 *                              По умолчанию 'admin', что соответствует force_ssl_admin() и is_ssl().
 * @return string URL административной области для конкретного сайта.
 */
function get_specific_admin_url( $blog_id, $path, $scheme ) {
    // Получаем URL административной области для конкретного сайта
    $specific_url = get_admin_url( $blog_id, $path, $scheme );
    return $specific_url;
}

В данном примере мы используем функцию get_admin_url для получения URL административной области для конкретного сайта. Функция get_specific_admin_url принимает три параметра: $blog_id — идентификатор сайта или null для текущего сайта, $path — путь относительно URL административной области, $scheme — схема, используемая для URL.

В данном примере мы просто вызываем функцию get_admin_url с переданными параметрами и возвращаем полученный URL административной области для конкретного сайта.