説明
void wp_new_user_notification( int $user_id [ , string $plaintext_pass $deprecated = null [ , string $notify = '' ] ] )
ユーザが登録されたことを管理者とユーザに通知する。
パラメータ
バージョン4.3.1～
- $user_idユーザIDを指定。
- $deprecated未使用（省略時はnull）。
- $notify通知方法として'admin'、'both'（[4.6.0]'user'が追加）を指定（省略時は''）。
バージョン4.3.0
- $user_idユーザIDを指定。
- $notify通知方法として'admin'、'both'を指定（省略時は''）。
バージョン2.0.0～4.2.x
- $user_idユーザIDを指定。
- $plaintext_passパスワードを指定。
返り値
返り値はありません。注意
ユーザ登録を管理者とそのユーザに通知する。バージョンにより通知内容・方法が異なり、4.6.0以降では管理者のみ（'admin'または''）、ユーザのみ（'user'）、両者（'both'）の選択が可能になっている。
[4.3.0]新規ユーザへの通知内容に対してパスワードの記載を止めたことに伴い、wp-login.phpで呼び出されていた'retrieve_password_key'アクションを呼ぶようになった。
[4.9.0]追加された'wp_new_user_notification_email_admin'フィルターにより、プラグインなどによりメール内容が変更可能になった。このフィルターの第1パラメータの連想配列は次の内容となる。
| キー | 内容 |
|---|---|
| 'to' | サイト管理者のメールアドレス |
| 'subject' | メールタイトル（既定値は'[%s] New User Registration'を翻訳したもの） |
| 'message' | 通知メールの文面（バージョンによって異なる） |
| 'headers' | メールのヘッダー情報（既定値は''） |
[4.9.0]追加された'wp_new_user_notification_email'フィルターにより、プラグインなどによりメール内容が変更可能になった。このフィルターの第1パラメータの連想配列は次の内容となる。
| キー | 内容 |
|---|---|
| 'to' | 登録されたユーザのメールアドレス |
| 'subject' | メールタイトル（既定値は'[%s] Your username and password info'を翻訳したもの） |
| 'message' | 通知メールの文面（バージョンによって異なる） |
| 'headers' | メールのヘッダー情報（既定値は''） |
使用例
- ユーザが登録されたことを管理者に通知する。<?php wp_new_user_notification( $user_id ); ?>
- ユーザが登録されたことをユーザのみに通知する。<?php wp_new_user_notification( $user_id, null, 'user' ); ?>
フィルター
[4.9.0]管理者に通知メールを送信する前に'wp_new_user_notification_email_admin'フィルターを呼び出す。パラメータ$wp_new_user_notification_email_adminにはメール内容を示す連想配列が、$userにはユーザ情報（WP_Userオブジェクト）が、$blognameにはデコード済みのブログ名が格納されている。$wp_new_user_notification_email_admin = apply_filters( 'wp_new_user_notification_email_admin', $wp_new_user_notification_email_admin, $user, $blogname );$wp_new_user_notification_email = apply_filters( 'wp_new_user_notification_email', $wp_new_user_notification_email, $user, $blogname );アクション
[4.3.0]ユーザに登録通知をする際に'retrieve_password_key'アクションを呼び出す。パラメータ$user_loginにはユーザのログイン名が、$keyには仮パスワードが格納されている。do_action( 'retrieve_password_key', $user_login, $key );ソースファイル
/wp-includes/pluggable.php最終更新 : 2018年05月27日 10:43
関連
お勧め
囲み型ショートコードとwpautop（2018年5月27日 更新）
ショートコードは投稿記事の閲覧時に動的に内容を変更できる優れもの。galleryやcaptionなどいくつかのショートコードが標準で組み込まれており、一部のプラグインではその機能を利用する手段としてショートコードが利用されている。
使っていないか確認しないとね！（フィルター編）（2019年4月24日 更新）
先週末にWordPress 5.2 Beta3（以降5.2Beta3）が公開され、正式リリースまであとわずか。ソースコードの変更点を見ていくと、wp-login.phpの中に非推奨となったフィルターが目に留まった。
Login rebuilder 2.5.0の新機能紹介（2018年12月10日 更新）
今回追加したものは、任意の名前でロックファイルを設定し、そのファイルが存在する場合は常にログイン不可にする機能である。この機能を有効にしておくことで、何らかの理由により認証に関する情報が漏洩した場合でも不正なログインを防ぐことができる。
時代はWP_Queryなのか（2011年8月1日 更新）
WordPressのテーマ作成において、メインの投稿記事とは別に特定の条件を指定した投稿内容を表示することが多々ある。つい最近まで get_posts関数を使用することが多かったのだが、最近はWP_Queryクラスを使用することが多くなってきた。query_posts（WP_Queryクラス）で'tax_query'を使いこなす（2011年9月14日 更新）
2日にわたって投稿した「query_posts（WP_Queryクラス）でカテゴリーを絞り込む」「query_posts（WP_Queryクラス）で投稿タグを絞り込む」の続き。今日はカテゴリーや投稿タグ以外ののタクソノミーによる絞り込み、複数のタクソノミーの絞り込みの組み合わせについてまとめてみる。