Функция wp_get_referer() предназначена для получения URL-адреса страницы, с которой пользователь пришел на текущую страницу. Она извлекает реферер из переменной $_REQUEST['_wp_http_referer'] или из переменной HTTP Referer. Если реферер совпадает с текущим URL, функция вернет значение false.
wp_get_referer(): string|falseВозвращаемое значение
- string|false — URL реферера в случае успеха или
false, если не удалось его получить.
Дополнительная информация
HTTP реферер — это серверная переменная, и важно отметить, что слово «referer» написано с ошибкой, что является стандартом в веб-технологиях.
Функция объединяет в себе логику двух других функций: wp_get_raw_referer() и wp_validate_redirect(), что делает ее удобным инструментом для работы с реферерами.
Пример 1: Создание ссылки «Вернуться назад»
Предположим, что вы находитесь на странице вашего плагина в админке WordPress и хотите вывести ссылку «Вернуться назад». Вот как это можно сделать:
<?php
$referer_url = wp_get_referer();
if ( $referer_url ) {
?>
<p><a class="button" href="<?php echo esc_url( $referer_url ); ?>">Вернуться назад</a></p>
<?php
}
?>
Заключение
Функция wp_get_referer() является полезным инструментом для управления навигацией на сайте и для создания удобных пользовательских интерфейсов. Она позволяет легко получить информацию о предыдущей странице и использовать ее для создания интерактивных элементов, таких как ссылки «Вернуться назад».