説明
mixed wp_signon( [ array $credentials = array() [ , mixed $secure_cookie = '' ] ] )
認証処理を行う。
パラメータ
- $credentials認証情報を連想配列で指定（省略時はarray()）。連想配列の内容は次の通り。
キー データ型 意味 'user_login' string ログイン名 'user_password' string パスワード 'remember' bool ログイン情報を保持する場合はtrue - $secure_cookieセキュアクッキーを使用する場合はtrueを指定（省略時は''）。
返り値
認証できた場合はユーザー情報オブジェクトを返す。認証に失敗した場合は WP_Errorオブジェクトを返す。注意
パラメータ$credentialsの省略時は$_POSTを参照するが、キー名が異なるので注意が必要である。
| $credentialsのキー | $_POSTのキー |
|---|---|
| 'user_login' | 'log' |
| 'user_password' | 'pwd' |
| 'remember' | 'rememberme' |
パラメータ$secure_cookie省略時は、 is_ssl関数の結果が適用される。
使用例
- $_POSTパラメータで認証処理を行う。<?php wp_signon(); ?>
- 連想配列を指定した$paramで認証処理を行う。<?php wp_signon( $param ); ?>
フィルター
[3.1.0]認証処理を行う（認証時のクッキーを出力する）前、'secure_signon_cookie'フィルターを実行する。パラメータ$secure_cookie、$credentialsは省略時処理済みの値が格納されている。$secure_cookie = apply_filters( 'secure_signon_cookie', $secure_cookie, $credentials );アクション
[1.5.1]$credentialsの初期処理後、'wp_authenticate'アクションを実行する。パラメータは配列で、索引0の要素がログイン名のポインタ、索引1の要素がパスワードのポインタが格納されている。do_action_ref_array( 'wp_authenticate', array( &$credentials['user_login'], &$credentials['user_password'] ) );do_action( 'wp_login', $user_login, $user );ソースファイル
/wp-includes/user.php最終更新 : 2014年07月24日 13:43
関連
お勧め
meta_compare_key使ってみた（2019年3月19日 更新）
ブロックエディターの登場により、標準のカスタムフィールドを使う機会はかなり減った気がする。そんな中、5.1.0で追加されたのが、カスタムフィールド名（メタキー）に含まれる文字列を指定する'meta_compare_key'キーだ。
WP_List_Tableクラスの「一括操作」フォームを使ってみた（2018年5月27日 更新）
今回は「WP_List_Tableクラスを使ってみた」の続き。投稿一覧やプラグインページなどにある「一括操作」（Bulkアクション）フォーム対応に関するメモである。
テーマから投稿画像のサイズを指定する（2012年3月15日 更新）
投稿記事に挿入する画像サイズは、サムネイル（150×150）、中サイズ（300×300）、大サイズ（1024×1024）がデフォルトだが、テーマによっては別のサイズを指定したい場合はある。基本的には、「設定」－「メディア」の「メディア設定」ページで指定できるが、テーマ内のfunctions.phpで設定しておくとちょっと便利かもしれない。ログインページを変える（2014年9月12日 更新）
WordPressの標準的な不正ログイン対策としては、ログインIDは'admin'を避けるパスワードはユニークで長くする、場合によってはアクセスできるIPアドレスを制限する、といった具合だろう。これらの他に何かできないものだろうかと、ちょっと考えてみた。新規投稿時の本文プレースホルダーテキストを変える（2021年9月9日 更新）
ブロックエディターに影響を与えるフィルターは多数存在する。今回紹介するフィルターはその1つで、新規投稿時の本文ブロックのプレースホルダーテキストを変更するものだ。