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
Кодекс WordPress: add_query_arg(), add_theme_support(), body_class(), bool_from_yn(), cache_javascript_headers(), do_robots(), get_bloginfo(), get_body_class(), get_num_queries(), get_query_var(), nocache_headers(), query_posts(), remove_query_arg(), status_header(), wp(), wp_cache_get(), wp_cache_set(), wp_check_filetype(), wp_die(), wp_editor(), wp_footer(), wp_get_archives(), wp_hash(), wp_head(), wp_list_pluck(), wp_mail(), wp_notify_moderator(), wp_notify_postauthor(), wp_parse_args(), wp_redirect(), wp_salt(), wp_text_diff(), wp_upload_bits()

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

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

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

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

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