- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
「関数リファレンス/wp signon」の版間の差分
提供: WordPress Codex 日本語版
< 関数リファレンス
細 (→解説: en link) |
細 |
||
(2人の利用者による、間の3版が非表示) | |||
1行目: | 1行目: | ||
− | < | + | == 説明<span id="Description"></span> == |
− | + | ||
− | </ | + | |
− | + | オプションとして渡される認証情報でユーザーを認証します。非推奨になった関数 [[関数リファレンス/wp_login|wp_login]] /[[:en:Function_Reference/wp_login|en]] の代わりです。 | |
− | < | + | == 使い方<span id="Usage"></span> == |
− | + | <?php wp_signon( $credentials, $secure_cookie ) ?> | |
− | < | + | |
− | + | ||
− | + | ||
− | + | ||
− | < | + | == パラメータ<span id="Parameters"></span> == |
− | + | ||
− | </ | + | |
− | {{Parameter|$credentials| | + | {{Parameter|$credentials|配列|サインインするためのユーザ情報|オプション}} |
− | {{Parameter|$secure_cookie| | + | {{Parameter|$secure_cookie|真偽値|セキュアな Cookie を使用するかどうか。|オプション}} |
− | ''' | + | '''参考:''' $credentials を省略すると、wp_signon() は変数 [http://php.net/manual/ja/reserved.variables.post.php <tt>$_POST</tt>] を利用します(キーは <tt>"log", "pwd"</tt> および <tt>"rememberme"</tt>)。 |
− | < | + | == 戻り値<span id="Return_Values"></span> == |
− | + | ||
− | </ | + | |
− | ; '''( | + | ; '''(オブジェクト)''' : 失敗すると <tt>[[クラスリファレンス/WP_Error|WP_Error]]</tt> を、成功すると <tt>[[クラスリファレンス/WP_User|WP_User]]</tt> を返します。 |
+ | |||
+ | == 用例<span id="Examples"></span> == | ||
+ | |||
+ | この関数とアクションはテーマの functions.php へ配置できます。 | ||
+ | フック after_setup_theme を使うとヘッダーとクッキーの送信前に実行できるので、ログインに必要なクッキーをセットすることができます。 | ||
− | |||
− | |||
− | |||
<pre><nowiki> | <pre><nowiki> | ||
− | $creds = array(); | + | function custom_login() { |
− | $creds['user_login'] = 'example'; | + | $creds = array(); |
− | $creds['user_password'] = 'plaintextpw'; | + | $creds['user_login'] = 'example'; |
− | $creds['remember'] = true; | + | $creds['user_password'] = 'plaintextpw'; |
− | $user = wp_signon( $creds, false ); | + | $creds['remember'] = true; |
− | if ( is_wp_error($user) ) | + | $user = wp_signon( $creds, false ); |
− | + | if ( is_wp_error($user) ) | |
+ | echo $user->get_error_message(); | ||
+ | } | ||
+ | // ヘッダーとクッキーの送信前にアクションを起動する。 | ||
+ | add_action( 'after_setup_theme', 'custom_login' ); | ||
</nowiki></pre> | </nowiki></pre> | ||
− | < | + | == 参考<span id="Notes"></span> == |
− | + | ||
− | </ | + | |
− | + | * この関数はヘッダーを送信します。そのためコンテンツが返されるより前に起動しなければなりません。 | |
+ | * この関数は認証用クッキーをセットします。送信しない場合、ユーザーはログインしません。 | ||
− | < | + | == 変更履歴<span id="Change_Log"></span> == |
− | + | ||
− | </ | + | |
− | + | 新規導入: 2.5.0 | |
− | < | + | == ソースファイル<span id="Source_File"></span> == |
− | + | ||
− | </ | + | |
+ | <tt>wp_signon()</tt> は {{Trac|wp-includes/user.php}} にあります。 | ||
+ | |||
+ | == 関連項目<span id="Related"></span> == | ||
+ | |||
+ | {{Tag Footer}} | ||
+ | |||
+ | {{原文|Function Reference/wp_signon|158791}} <!--11:48, 5 November 2016 Glutaminefree 版 --> | ||
+ | |||
+ | {{DEFAULTSORT:Wp_signon}} | ||
[[Category:関数]] | [[Category:関数]] | ||
+ | |||
+ | [[en:Function Reference/wp_signon]] | ||
+ | [[it:Riferimento funzioni/wp_signon]] |
2018年7月7日 (土) 22:34時点における最新版
説明
オプションとして渡される認証情報でユーザーを認証します。非推奨になった関数 wp_login /en の代わりです。
使い方
<?php wp_signon( $credentials, $secure_cookie ) ?>
パラメータ
- $credentials
- (配列) (オプション) サインインするためのユーザ情報
- 初期値: なし
- $secure_cookie
- (真偽値) (オプション) セキュアな Cookie を使用するかどうか。
- 初期値: なし
参考: $credentials を省略すると、wp_signon() は変数 $_POST を利用します(キーは "log", "pwd" および "rememberme")。
戻り値
用例
この関数とアクションはテーマの functions.php へ配置できます。 フック after_setup_theme を使うとヘッダーとクッキーの送信前に実行できるので、ログインに必要なクッキーをセットすることができます。
function custom_login() { $creds = array(); $creds['user_login'] = 'example'; $creds['user_password'] = 'plaintextpw'; $creds['remember'] = true; $user = wp_signon( $creds, false ); if ( is_wp_error($user) ) echo $user->get_error_message(); } // ヘッダーとクッキーの送信前にアクションを起動する。 add_action( 'after_setup_theme', 'custom_login' );
参考
- この関数はヘッダーを送信します。そのためコンテンツが返されるより前に起動しなければなりません。
- この関数は認証用クッキーをセットします。送信しない場合、ユーザーはログインしません。
変更履歴
新規導入: 2.5.0
ソースファイル
wp_signon() は wp-includes/user.php
にあります。
関連項目
関数リファレンス、テンプレートタグ目次もご覧ください。
最新英語版: WordPress Codex » Function Reference/wp_signon (最新版との差分)