wp_validate_redirect

（2.8.1以降）
wp_validate_redirect - URLがリダイレクト先として有効か調べる

説明

string wp_validate_redirect( string $locaution [ , string $default = '' ] )
URLがリダイレクト先として有効か調べる。

パラメータ

  • $locaution
    リダイレクト先のURLを指定。
  • $default
    無効な場合のURLを指定（省略時は''）。

返り値

パラメータ$locautionが有効なURLの場合はそれを返す。無効な場合（スキーマが'http'または'https'以外か、ホスト名が指定されていない場合を含む）はパラメータ$defaultの値を返す。

注意

パラメータ$locautionが'//'ではじまっている場合、先頭に'http:'が挿入される。

使用例

  • $urlが有効か調べる。
    <?php $url = wp_validate_redirect( $url, admin_url() ); ?>

フィルター

パラメータ$locautionにスキーマ、ホスト名が設定されている場合、allowed_redirect_hostsフィルターが実行される。$home_hostには home_url関数で取得できるホームURLのホスト名を含んだ配列が、$locaution_hostにはパラメータ$locautionのホスト名が格納される。
$allowed_hosts = (array) apply_filters( 'allowed_redirect_hosts', $home_host, $locaution_host );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/pluggable.php

最終更新 : 2016年04月22日 16:05

関連

参考

Code Reference: wp_validate_redirect

お勧め

4.4では投稿ページも専用テンプレートが適用できる（2018年5月27日 更新）

従来、特定の固定ページには専用テンプレートを適用できるのですが、投稿ページに適用させるためにはアクションやフィルターを利用する必要がありました。4.4では特定の投稿ページに標準で専用テンプレートを適用できるようになりそうです。

プラグインで注意が必要な関数（2013年11月27日 更新）

先日「Login rebuilder」という自作プラグインをアップデートした際、ユーザーさんからエラーになると連絡をいただいた。標準環境では問題なく、どうやら何らかのプラグインが影響しているらしい。

タイトルのみをキーワード検索する（2014年4月3日 更新）

WordPressのキーワード検索は、投稿タイトルと本文のどちらかに指定したキーワードが含まれているかを調べるわけだが、時々タイトルだけとか、逆に本文だけ検索したいケースがある。

oEmbedについて考えてみた（2018年5月27日 更新）

本サイト向けにテーマをリニューアルしようと思い一から作っている最中、ふと生成されているHTMLの中にあるoEmbedの記述が目についた。「この記述いつからだっけ」くらいに思いながらリンク先を開き、ちょっとモヤモヤしてしまった。

一定時間でログアウトする（2013年5月23日 更新）

ログイン関係を調べている関係で、 wp_set_auth_cookie関数に行き着く。ログイン画面の「ログイン状態を保持する」がチェックされた場合、クッキーの有効期限は14日間。チェックされていない場合は、ブラウザが閉じるまで常に有効となっているんだね。