wp_nonce_url()

2.0.4 wp-includes / functions.php / Кодекс WordPress

Добавляет значение одноразового ключа в URL в качестве $_GET-параметра. Перед тем, как вернуть URL, очищает результат функцией esc_html(), а значит, преобразует символы & в &.

Читайте, что такое одноразовые числа (nonces) и для чего они нужны в этом уроке.

wp_nonce_url( $actionurl, $action = -1, $name = '_wpnonce' )

$actionurl: (строка) URL, к которому нужно добавить нонс-ключ.
$action: (строка|целое) Ключ, описывающий действие, на основе которого будет создано одноразовое число. Обратите внимание, что рекомендуется подробно описывать действие. Например, если вы хотите сохранить настройки определённого поста, то значение $action может быть например 'save-post-' . $post_id.
$name: (строка) Название $_GET-параметра, которым будет добавлен нонс.

Примеры

На самом деле в описании функции wp_create_nonce() я использовал её для добавления параметра в URL. Предлагаю этот пример и переделать.

Итак, было:

$comment_id = 5;
$url = add_query_arg(
	array(
		'action' => 'delete-comment',
		'comment_id' => $comment_id,
		'nonce' => wp_create_nonce( 'delete-comment-' . $comment_id )
	),
	site_url( 'form.php' )
);
echo '<a href="' . $url . '">Удалить коммент</a>';

Стало:

$comment_id = 5;
$url = wp_nonce_url(
	add_query_arg( // первый параметр – URL
		array(
			'action' => 'delete-comment',
			'comment_id' => $comment_id
		),
		site_url( 'form.php' )
	),
	'delete-comment-' . $comment_id, // второй параметр – экшен
	'nonce' // третий параметр – в какой $_GET-параметр запишется одноразовое число
);
echo '<a href="' . $url . '">Удалить коммент</a>';

Ну или вот ещё пример:

// допустим, у нас есть какой-то URL с двумя параметрами
$url = 'http://localhost/?arg1=value1&arg2=value2';
 
// выведет http://localhost/?arg1=value1&amp;arg2=value2&amp;_wpnonce=abcdef
echo wp_nonce_url( $url, 'action' );
 
// выведет http://localhost/?arg1=value1&arg2=value2&_wpnonce=abcdef
echo add_query_arg( '_wpnonce', wp_create_nonce( 'action' ), $url );

Кодекс WordPress: Одноразовые числа: check_ajax_referer(), wp_create_nonce(), wp_nonce_field(), wp_nonce_url(), wp_verify_nonce()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.