【WordPress】組み込みのwp_mailファンクションを使って、１ファイルでメールフォームを作る方法

今回はWordPress組み込みのwp_mailファンクションで、１ファイルでサクッとメールフォームを作ってみます。わりとシンプルな構造になったので、使いまわししやすいかもしれません。さっそく、内容を見ていきましょう。

WordPressで１ファイルでサクッとメールフォームを作るメリットは？

WordPressには便利なプラグインがいっぱいあります。メールに関してもそうです。しかしものによっては『構成ファイルやフロント出力されるスクリプトが多い・設定が大変』というような難点もありました。また、メールプラグインのエクステンション入れたら、バージョンアップでエラー

今回の『１ファイルでサクッとメールフォーム』は、なるべく構成をシンプルにして、余計なスクリプトやＣＳＳロードも最小限におさえたので、ページのロード速度やメンテナンス性でメリットがあるかなと思います。

wp_mailファンクション使用　１ファイルでサクッとメールフォームを作るコード

というわけで、テスト的に管理人が持っているサイト『著作権フリー曲サイトSSF』につけてみました。環境はWordPress 6.4.3 & PHP バージョン7.4.33 ではokで、他のサイト（WordPress 6.5 & PHP バージョン8.2.17 ）でも動作しました。バージョン5.6とか古い場合は未検証です。

コード・ポイント

コードはこんな感じになりました。wp_mailファンクションは送信するほかに『送信結果を返す』というのがあるので、それがtrue出ない場合は入力用・バリデーション結果などでフォームを表示させています。

基本的には、フロントで入力されたかチェックするほかに、『array_key_exists』で入っているか判定、組み込みの『wp_verify_nonce，is_email』でnonceやアドレス形式チェックを行います。okならエスケープして本文にセット。

エラー情報配列が空（全部false）だった場合はメール文セットと送信。最近gmailなどのなりすましメール判定が厳しいので、差出人情報は設置したページと同じドメインのアドレスが安全です。$mail_toは送信した人あてになり、Bccで同じ内容を管理者にも送ることができます。

フォーム表示部分です。フォーム内容を『required（必須）』にするほか、wp_nonce_fieldでnonceをセットします。リセットボタンについては、typeがリセットだとPHPで送信内容を元にセットしたものがリセットされない、というようなことがあるので、javascriptで内容リセットするようにしています。

使い方（固定ページのスラッグ：mailを想定）

とりあえず、『mail.php』という名前にして、テーマの任意のディレクトリに入れておきました（テーマ内のpartsディレクトリ）。しかしFTP画面で見たら、ファイルサイズ4580バイトしかないんですね（笑）

で、固定ページスラッグが『mail』のとき、get_template_partでロードする、という流れにしました。これで固定ページ『mail』でフォームが使えます。

cssについては？

SSFのサイトにつけたときのＣＳＳは以下のような感じです。

これは追加した分だけなので、一部親要素を継承しているので書いていないところもあります。サイトにあわせて変更してください。

表示・操作例や送信結果

ではさっそく、表示を確認してみます。管理人のサイトSSFにつけてみたところ、こんな感じのフォームに。CSSはお好みでどうぞ。（そこしか使わないので、特定のページだけ判定して出力、などがおススメです）

いちおうバックエンドでもバリデーションは入れていますが、フロントでもフォームに細工して（例えばrequired）、2重チェックのようにすることができます。安全のため、フロント/バックエンドの2重チェックが推奨されています。

is_emailファンクションは、変な形式のメールアドレスを入れたとき、ハネてくれます。ただしソース見た感じだと形式に沿ってるかをチェックしていて、実際に使われているアドレスかどうかまでは、チェックしないっぽいですね

送信okのときは、メッセージで告知＆トップリダイレクトという形にしました。setTimeout3000ミリセコンドでwindow.locationを行います。サンクスページとかに飛ばしてもokです。

送信者には、こんな感じで自動返信メールが届き、管理者にも同じ内容が届きます。

あとがき・まとめ

まとめると、こんなところでしょうか。サイズ4kb～5kbくらいのコードで、軽量にできたと思います。ほかにもWordPress/Laravel etc.で機能開発しているので、出来たらこのサイトでお知らせします。