add_query_arg() — добавляет параметры в строку URL-вида

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

Позволяет добавить один или несколько параметров в URL-строку вида параметр_1=значение_1&параметр_2=значение_2. В результате возвращает строку с уже присутствующими в ней параметрами.

# Первый аргумент - название параметра, второй - его значение
add_query_arg( $key_1, $value_1, $old_query_or_uri );
 
# Параметры в виде массива вида ключ=>значение
add_query_arg( array('key_1' => 'value_1', ...), $old_query_or_uri );

$old_query_or_uri: (строка|логическое) первоначальная строка, по умолчанию $_SERVER[REQUEST_URI]

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

$old_query_or_uri = 'wp-admin/post.php?post=555&action=edit';
$new_query = add_query_arg( 'param_1', 'value_1', $old_query_or_uri );
echo $new_query // wp-admin/post.php?post=555&action=edit¶m_1=value_1

Точно такой же пример, как и предыдущий, отличается лишь способом указания параметров:

$new_query = add_query_arg( array('param_1' => 'value_1'), 'wp-admin/post.php?post=555&action=edit' );
echo $new_query // wp-admin/post.php?post=555&action=edit¶m_1=value_1

Пример с добавлением, а также удалением параметров из строки аргументов объекта WP_Query:

$new_args = array(
	'orderby' => 'name',
	'order' => 'ASC',
	'cat' => false
);
 
$new_query = add_query_arg( $new_args, 'posts_per_page=10&cat=5' );
echo $new_query; // posts_per_page=10&orderby=name&order=ASC

Предположим, на основной странице блога я использовал следующий код:

$new_query = add_query_arg( array('param_1' => 'value_1') );
echo $new_query // /blog/?param_1=value_1

Миша

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

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