wp_nonce_ays()
Останавливает выполнение сценария PHP и выводит заглушку "The link you followed has expired" со ссылкой на предудущую страницу wp_get_referer().
Использовать эту функцию можно в случаях, когда нужно остановить выполнение сценария и вернуть пользователя на предыдущую страницу (HTTP referer).
Код состояния HTTP создаваемой страницы заглушки: 403 - запрещено.
Возвращает
null
. Ничего не возвращает, а прерывает текущий PHP сценарий заглушкой.
Хуков нет.
Использование
<?php wp_nonce_ays( $action ) ?>
- $action(строка) (обязательный)
- Если передать значение
log-out
, то будет показана заглушка выхода из системы, со ссылкой на выход: "Вы уверены, что хотите выйти".
Примеры
#1 Неправильная ссылка
В случае неправильного URL можно вернуть пользователя обратно. Используем такую логику:
global $wp; $current_url = home_url( $wp->request ); // если $current_url "неправильный" if( $current_url === "https://example.com/destroy/the/world" ){ wp_nonce_ays( 'any string' ); // останавливаем сценарий со ссылкой на предыдущую страницу } else { // URL верный, выполняем сценарий дальше }
#2 Подтверждение выхода
Если нужно предупредить пользователя, что он собирается выйти из системы, то используем такой код, до того как "разлогинить" пользователя:
if( $_GET['logout'] ){ wp_nonce_ays( 'log-out' ); }
Список изменений
С версии 2.0.4 | Введена. |