wp_mail_from フックの使い方|説明・引数・注意点

説明

wp_mail_from は、メールの送信元アドレスを変更するフィルターです。

基本構文

apply_filters( 'wp_mail_from', string $from_email )

引数

  • $from_email:送信元メールアドレス

戻り値

送信元アドレスを返します。

使い方(サンプル)

add_filter( 'wp_mail_from', function() {
	return 'info@example.com';
} );

注意点

  • 送信元ドメインとサーバーが一致しないと、迷惑メール扱いされやすくなります。

実務での使いどころ

  • wp_mail() で送るメールの、送信元メールアドレスを、変えるとき。

よくあるミスと対処

  • メールアドレスを、返していない。
  • 返す値が、空や不正なアドレスだと、送信に失敗する。From を個別に指定したメールにも、適用される。
  • 送信元のドメインが、サイトのドメインと違い、迷惑メールとして扱われやすい。
  • 送信元の名前を変えたいのに、使っている。名前は、wp_mail_from_name フィルター。

NG例

add_filter( 'wp_mail_from', function () {
	echo 'info@example.com'; // 返さず、出力している
} );

OK例

add_filter( 'wp_mail_from', function ( $email ) {
	return 'info@example.com';
} );
add_filter( 'wp_mail_from_name', function ( $name ) {
	return 'サイト名';
} );

使い分け早見表

フィルター 変更する対象
wp_mail_from 送信元のメールアドレス
wp_mail_from_name 送信元の名前
wp_mail() メールを、送る関数

関連項目

wp_mail()

公式リファレンス:wp_mail_from | WordPress Developer Resources

コメント

タイトルとURLをコピーしました