add_query_arg

(1.5.0以降)
add_query_arg - クエリーURIを更新する

説明

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

関連

参考

Code Reference: add_query_arg

お勧めコンテンツ

開発環境（Windows 8）にimagickを入れる（2012年12月23日 登録）

WordPress 3.5のイメージエディタ（WP_Image_Editor）は、GDだけでなく、imagick（ImageMagick）にも対応している。そんなわけでWindows 8の開発環境にimagickをインストールしてみた。

get_postsとquery_postsを使い分け（2011年1月21日 登録）

get_postsとquery_postsは、どちらも複数の投稿情報を取得することができる便利な関数である。パラメータとして指定できる内容も共通しているものが多く、query_postsがより詳細なパラメータを指定でき、高機能になっている。

「投稿に挿入」時のタグをちょっとカスタマイズ（2011年7月29日 登録）

投稿画面において、画像をアップロードし投稿に挿入するすると、imgタグをaタグで囲んだものが挿入される（キャプションを指定した場合はタグも）。それらの画像をLightBox（JavaScriptライブラリ）で表示する場合、aタグにrel属性を追加するのだが、その作業を毎回投稿に挿入した後で行うのがちょっと面倒。というわけで、自動的にrel属性を追加するようにしてみました。

oEmbed対応サイトを整理した（2014年9月3日 登録）

投稿記事にTwitterやYouTubeのURL（アドレス）を記述したとき、表示されるページにはリンクとしてではなく、埋め込んだURLの内容が表示される。この仕組み（機能）はoEmbedというもので、対応サイトは随時バージョンアップしている。

適切なテンプレートファイルを用意してテンプレート内の振り分け処理を無くす（2011年10月18日 登録）

/wp-includes/template-loader.phpではリクエストされたページに応じて現在のテーマにあるテンプレートファイルの中から適切なものを選びに振り分けている。ここでは、さまざまなテンプレートファイルの種類と、テンプレートファイルが省略された場合の内部の動作についてまとめてみる。

最終更新日時 : 2013-01-22 17:55