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

Позволяет добавить один или несколько параметров в 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&param_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&param_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

Источник: misha.blog

Миша Рудрастых

Путешествует по миру и рассказывает всем о WordPress лично, у себя в блогах и на курсах в Санкт-Петербурге. Умеет просто объяснять сложные вещи, делает это красиво. Организовывает неплохие WordCamp's, но совсем не умеет слушать чужие доклады.

Добавить комментарий

%d такие блоггеры, как: