説明
string add_query_arg( mixed $param1 [ , mixed $param2 [ , mixed $param3 ] ] )
クエリーURIを更新する。
パラメータ
- $param1キー名または更新するキー名と値を含んだ連想配列
- $param2キー名に対応する値またはクエリーURIを指定
- $param3クエリーURIを指定
返り値
更新されたクエリーURIを返す。注意
パラメータ$param2、$param3を省略した場合は、$_SERVER['REQUEST_URI']が更新対象となる。クエリーURIにキー名のパラメータがある場合は値を更新し、ない場合は追加する。また第1パラメータがキー名で第2パラメータに値としてfalseまたはnullを指定した場合は、そのパラメータ（キー=値）がクエリーURIから削除される。
使用例
- $_SERVER['REQUEST_URI']に's=keyword'を追加（更新）する（1）。<?php $new_uri = add_query_arg( 's', 'keyword' ); ?>
- $_SERVER['REQUEST_URI']に's=keyword'を追加（更新）する（2）。<?php $new_uri = add_query_arg( 's', 'keyword', $_SERVER['REQUEST_URI'] ); ?>
- $_SERVER['REQUEST_URI']に's=keyword&paged=2'を追加（更新）する（1）。<?php $new_uri = add_query_arg( array( 's'=>'keyword', 'paged'=>2 ) ); ?>
- $_SERVER['REQUEST_URI']に's=keyword&paged=2'を追加（更新）する（2）。<?php $new_uri = add_query_arg( array( 's'=>'keyword', 'paged'=>2 ), $_SERVER['REQUEST_URI'] ); ?>
- $_SERVER['REQUEST_URI']からキー名's'のパラメータを削除する（1）。<?php $new_uri = add_query_arg( 's' ); ?>
- $_SERVER['REQUEST_URI']からキー名's'のパラメータを削除する（2）。<?php $new_uri = add_query_arg( 's', false ); ?>
- $_SERVER['REQUEST_URI']からキー名's'のパラメータを削除する（3）。<?php $new_uri = add_query_arg( 's', false, $_SERVER['REQUEST_URI'] ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/functions.php最終更新 : 2013年01月22日 17:55
関連
お勧め
親子の固定ページで同じテンプレートを使う（2013年3月20日 更新）
固定ページのテンプレートファイルは「page.php」か、ページ名（スラッグ）または投稿IDを指定したテンプレートファイルになる。固定ページでページデザインが数パターンある場合、通常は「page.php」で振り分けることになるが、もう少しスマートにできないか考えてみた。ポップアップのログインフォームに何か表示する（2018年11月6日 更新）
まもなくリリースされるWordPress 5.0にタイミングを合わせて「Login rebuilder」プラグインのアップデートを予定している。管理画面にログインしてしばらく操作しないと、ログインフォームがポップアップ表示される。このログインフォームに何かを表示するのが今回の内容だ。
固定ページを投稿ページ用テンプレートファイル（single.php）で表示する（2013年7月31日 更新）
固定ページと投稿ページのデザインが共通の場合、同じ内容のsingle.phpとpage.phpを用意すれば事足りるが、デザインの修正時は二度手間になってしまう。そこで、固定ページをsingle.phpで表示するようにできないか考えてみた。
Login rebuilder：プラグイン作ってみました（2019年9月7日 更新）
昨年投稿した「ログインページを変える」をプラグイン化。ログインページを独自の名前のページ変更し、標準のログインページwp-login.phpを使用できないようにするプラグインです。部外者によるwp-login.phpのアクセスにお悩みの方にお勧めします。また2.0.0では「XML-RPCリクエストの管理機能」を追加。2.2.0では管理者のログイン時にメールで通知する機能を追加しました。使っていないか確認しないとね！（2017年11月18日 更新）
2003年に誕生したWordPress。その歴史の中には、廃止予定（deprecated）となっている関数がいくつも存在する。それらの関数をテーマやプラグインで使用するべきではないし、使用しているなら代替の関数に書き換えるべきである。ここでは