当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「関数リファレンス/wp new user notification」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(08:21, 31 October 2013 Gerardoritchey 版を和訳)
 
(説明: パスワードに関する誤記を訂正。)
 
(2人の利用者による、間の2版が非表示)
1行目: 1行目:
<div id="Description">
+
== 説明<span id="Description"></span> ==
== 説明 ==
+
</div>
+
電子メールで、ブログ管理者に新しいユーザーの登録を通知し、新しいユーザーにはログイン/パスワードを通知します。
+
  
この関数は、[[用語集#Plugin|プラグイン]]を介して変更をすることができます。プラグインでこの機能を定義しない時、これが代わりに使用されます。
+
電子メールで、ブログ管理者に新しいユーザーの登録を通知し、新しいユーザーにはログイン(ユーザー名)とパスワード設定用リンク URL を通知します。
  
<div id="Usage">
+
この関数は[[用語集#Plugin|プラグイン]]を使って内容を変更できます。プラグインで同じ名前の関数を定義しなければ、これが代わりに使用されます。
== 使い方 ==
+
</div>
+
<?php wp_new_user_notification( $user_id, $plaintext_pass ) ?>
+
  
<div id="Parameters">
+
== 使い方<span id="Usage"></span> ==
== パラメータ ==
+
</div>
+
{{Parameter|$user_id|整数|ユーザ ID|必須|None}}
+
{{Parameter|$plaintext_pass|文字列|ユーザの平文パスワード。|オプション|&#39;&#39;}}
+
  
<div id="Return_Values">
+
<?php wp_new_user_notification( $user_id, $deprecated, $notify ) ?>
== 戻り値 ==
+
</div>
+
なし
+
  
<div id="Examples">
+
== パラメータ<span id="Parameters"></span> ==
== 用例 ==
+
</div>
+
  
<pre>
+
{{Parameter|$user_id|整数|ユーザー ID|必須}}
// ユーザ通知機能を再定義
+
{{Parameter|$deprecated|null|(このパラメータは廃止されました。)|オプション}}
if ( !function_exists('wp_new_user_notification') ) {
+
{{Parameter|$notify|文字列|通知の種類。|オプション|&#39;&#39;}}
 +
:* <code>'admin'</code> または空文字列 &ndash; 管理者のみへ通知。
 +
:* <code>'user'</code> &ndash; ユーザーのみへ通知。
 +
:* <code>'both'</code> &ndash; 管理者とユーザーの両方へ通知。
  
function wp_new_user_notification( $user_id, $plaintext_pass = '' ) {
+
== 戻り値<span id="Return_Values"></span> ==
  
$user = new WP_User( $user_id );
+
なし。
  
$user_login = stripslashes( $user->user_login );
+
== 用例<span id="Examples"></span> ==
$user_email = stripslashes( $user->user_email );
+
  
$message  = sprintf( __('New user registration on %s:'), get_option('blogname') ) . "\r\n\r\n";
+
<pre>
$message .= sprintf( __('Username: %s'), $user_login ) . "\r\n\r\n";
+
// ユーザー通知関数を再定義
$message .= sprintf( __('E-mail: %s'), $user_email ) . "\r\n";
+
if ( ! function_exists( 'wp_new_user_notification' ) ) {
 +
    function wp_new_user_notification( $user_id, $deprecated, $notify ) {
 +
        $user = new WP_User( $user_id );
 +
 
 +
        $user_login = stripslashes( $user->user_login );
 +
        $user_email = stripslashes( $user->user_email );
 +
 
 +
        $message  = sprintf( __('New user registration on your blog %s:'), get_option( 'blogname' ) ) . "\r\n\r\n";
 +
        $message .= sprintf( __('Username: %s'), $user_login ) . "\r\n\r\n";
 +
        $message .= sprintf( __('E-mail: %s'), $user_email ) . "\r\n";
 +
 
 +
        @wp_mail( get_option( 'admin_email' ), sprintf( __('[%s] New User Registration'), get_option( 'blogname' ) ), $message );
 +
    }
 +
}
 +
</pre>
  
@wp_mail(
+
== 参考<span id="Notes"></span> ==
get_option('admin_email'),
+
sprintf(__('[%s] New User Registration'), get_option('blogname') ),
+
$message
+
);
+
  
if ( empty( $plaintext_pass ) )
+
新しいユーザーを <tt>wp_insert_user()</tt> で登録した後、この関数 <tt>wp_new_user_notification()</tt> を呼び出せば新規登録されたユーザーへメールを送ることができます。
return;
+
この動作をカスタマイズするには、新しく定義したこの関数をプラグインとして保存しなければなりません。しかし、他のプラグイン(あなたのプラグインより前に呼び出されたもの)が優先される可能性があります。そこでカスタマイズに最適な方法は、Must-use プラグインとして保存します。そのためには <code>wp-content</code> の直下にフォルダー <code>mu-plugins</code> を作り、その中へプラグインのファイルを保存します。
 +
Must-use プラグインについて詳しくは [[:en:Must_Use_Plugins|Must_Use_Plugins (英文)]] をお読みください。
  
$message  = __('Hi there,') . "\r\n\r\n";
+
== 変更履歴<span id="Change_Log"></span> ==
$message .= sprintf( __("Welcome to %s! Here's how to log in:"), get_option('blogname')) . "\r\n\r\n";
+
$message .= wp_login_url() . "\r\n";
+
$message .= sprintf( __('Username: %s'), $user_login ) . "\r\n";
+
$message .= sprintf( __('Password: %s'), $plaintext_pass ) . "\r\n\r\n";
+
$message .= sprintf( __('If you have any problems, please contact me at %s.'), get_option('admin_email') ) . "\r\n\r\n";
+
$message .= __('Adios!');
+
  
wp_mail(
+
* [[Version 4.6|4.6.0]] : パラメータ <tt>$notify</tt> へ <code>'user'</code> を指定すると作成されたユーザーのみへ通知を送る。
$user_email,
+
* [[Version 4.3.1|4.3.1]] : パラメータ <tt>$plaintext_pass</tt> を廃止。<tt>$notify</tt> を第3パラメータとして追加。
sprintf( __('[%s] Your username and password'), get_option('blogname') ),
+
* [[Version 4.3|4.3.0]] : パラメータ <tt>$plaintext_pass</tt> を <tt>$notify</tt> へ変更。
$message
+
* [[Version 2.0|2.0.0]] : 新規導入。
);
+
}
+
}
+
</pre>
+
 
+
<div id="Notes">
+
== 参考 ==
+
</div>
+
* この関数は、[[用語集#Plugin|プラグイン]]を介して変更をすることができます。プラグインでこの機能を定義しない時、これが代わりに使用されます。
+
 
+
<div id="Change_Log">
+
== 変更履歴 ==
+
</div>
+
バージョン 2.0 から導入されました。
+
  
 
<div id="Source_File">
 
<div id="Source_File">
86行目: 64行目:
 
</div>
 
</div>
  
[[関数リファレンス/wp_password_change_notification|wp_password_change_notification()]]
+
[[関数リファレンス/wp_password_change_notification|wp_password_change_notification()]] /[[:en:Function_Reference/wp_password_change_notification|en]]
  
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{原文|Function_Reference/wp_new_user_notification}} <!-- 08:21, 31 October 2013 Gerardoritchey 版 -->
+
{{原文|Function_Reference/wp_new_user_notification}} <!-- Home / Reference / Functions / wp_new_user_notification() -->
  
 
{{DEFAULTSORT:Wp_new_user_notification}}
 
{{DEFAULTSORT:Wp_new_user_notification}}
[[Category:関数]]
+
[[Category:プラガブル関数]]
  
[[en:Function Reference/wp_set_post_tags]]
+
[[en:Function Reference/wp_new_user_notification]]

2017年9月1日 (金) 00:41時点における最新版

説明

電子メールで、ブログ管理者に新しいユーザーの登録を通知し、新しいユーザーにはログイン(ユーザー名)とパスワード設定用リンク URL を通知します。

この関数はプラグインを使って内容を変更できます。プラグインで同じ名前の関数を定義しなければ、これが代わりに使用されます。

使い方

<?php wp_new_user_notification( $user_id, $deprecated, $notify ) ?>

パラメータ

$user_id
整数) (必須) ユーザー ID
初期値: なし
$deprecated
null) (オプション) (このパラメータは廃止されました。)
初期値: なし
$notify
文字列) (オプション) 通知の種類。
初期値: ''
  • 'admin' または空文字列 – 管理者のみへ通知。
  • 'user' – ユーザーのみへ通知。
  • 'both' – 管理者とユーザーの両方へ通知。

戻り値

なし。

用例

// ユーザー通知関数を再定義
if ( ! function_exists( 'wp_new_user_notification' ) ) {
    function wp_new_user_notification( $user_id, $deprecated, $notify ) {
        $user = new WP_User( $user_id );
  
        $user_login = stripslashes( $user->user_login );
        $user_email = stripslashes( $user->user_email );
  
        $message  = sprintf( __('New user registration on your blog %s:'), get_option( 'blogname' ) ) . "\r\n\r\n";
        $message .= sprintf( __('Username: %s'), $user_login ) . "\r\n\r\n";
        $message .= sprintf( __('E-mail: %s'), $user_email ) . "\r\n";
  
        @wp_mail( get_option( 'admin_email' ), sprintf( __('[%s] New User Registration'), get_option( 'blogname' ) ), $message );
    }
}

参考

新しいユーザーを wp_insert_user() で登録した後、この関数 wp_new_user_notification() を呼び出せば新規登録されたユーザーへメールを送ることができます。 この動作をカスタマイズするには、新しく定義したこの関数をプラグインとして保存しなければなりません。しかし、他のプラグイン(あなたのプラグインより前に呼び出されたもの)が優先される可能性があります。そこでカスタマイズに最適な方法は、Must-use プラグインとして保存します。そのためには wp-content の直下にフォルダー mu-plugins を作り、その中へプラグインのファイルを保存します。 Must-use プラグインについて詳しくは Must_Use_Plugins (英文) をお読みください。

変更履歴

  • 4.6.0 : パラメータ $notify'user' を指定すると作成されたユーザーのみへ通知を送る。
  • 4.3.1 : パラメータ $plaintext_pass を廃止。$notify を第3パラメータとして追加。
  • 4.3.0 : パラメータ $plaintext_pass$notify へ変更。
  • 2.0.0 : 新規導入。

ソースファイル

wp_new_user_notification()wp-includes/pluggable.php にあります。

wp_password_change_notification() /en


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function_Reference/wp_new_user_notification