This page is also available in English.
コンタクトフォームから入力されたテキスト以上の情報が必要になるときもあるでしょう。たとえば、セキュリティ上の理由で送信者の IP アドレスを知りたいというような場合です。そういった目的には特別なメールタグが役に立ちます。
その他のメールタグとは異なり、特別なメールタグはフォームの入力項目や送信者が入力する内容からは独立しています。特別なメールタグはメールタグを使える場所ならどこにでも設置できます。たとえばメッセージ本文やその他のメール項目の中などです。
送信関連の特別なメールタグ
[_remote_ip]
— このタグは送信者の IP アドレスで置き換えられます。
[_user_agent]
— このタグは送信者のユーザーエージェント(ブラウザ)情報で置き換えられます。
[_url]
— このタグはコンタクトフォームが設置されているページの URL で置き換えられます。
[_date]
— このタグは送信の日付で置き換えられます。
[_time]
— このタグは送信の時刻で置き換えられます。
[_invalid_fields]
— このタグは不正な入力のあった入力項目の数で置き換えられます。
[_serial_number]
— このタグはインクリメントする数値で置き換えられます。つまり、個々の送信のシリアルナンバーとして機能します。Flamingo 1.5以上がインストールされていることが必要です。
投稿関連の特別なメールタグ
これらの特別なメールタグはコンタクトフォームが含まれる投稿に関する情報を提供します。
これらの [_post_*] タグは、コンタクトフォームが投稿内容の内部に設置されている場合に限り機能するということに注意してください。コンタクトフォームが投稿内容の外側にある場合、たとえばサイドバーウィジェットの中に設置されていたりテーマのテンプレートファイルの中に埋め込まれているような場合は、空のテキストでタグが置き換えられます。
[_post_id]
— このタグは投稿の ID で置き換えられます。
[_post_name]
— このタグは投稿の名前(スラッグ)で置き換えられます。
[_post_title]
— このタグは投稿のタイトルで置き換えられます。
[_post_url]
— このタグは投稿のパーマリンク URL で置き換えられます。
[_post_author]
— このタグは投稿の作成者名で置き換えられます。
[_post_author_email]
— このタグは投稿の作成者のメールアドレスで置き換えられます。
サイト関連の特別なメールタグ
これらの特別なメールタグはその上でコンタクトフォームが管理されている WordPress のウェブサイトに関する情報を提供します。一揃いのコンタクトフォームのテンプレートを多数のウェブサイト間で使いまわしたい場合、個々のサイトのために手作業で情報を書き換える手間から解放されるので、特に便利に思うでしょう。
[_site_title]
— このタグはウェブサイトのタイトルで置き換えられます。
[_site_description]
— このタグはウェブサイトの説明文で置き換えられます。
[_site_url]
— このタグはウェブサイトのホームページ URL で置き換えられます。
[_site_admin_email]
— このタグはウェブサイトの管理者ユーザーのメールアドレスで置き換えられます。
ユーザー関連の特別なメールタグ
これらの特別なメールタグはログインしているユーザーの情報を提供します。
これらの [_user_*] タグは送信者が WordPress サイトにアカウントを持っているユーザーで、かつログイン中である場合に限って機能するものですので、これらのタグを使うときは購読者限定モードを有効にすることが推奨されます。
これらのタグを使いたいけれど購読者限定モードにはしたくない、という場合がもしあるなら、明示的にノンスの使用を有効にしてください。そうしなければ、WP REST API によってログインユーザーのデータがリセットされ、空のテキストによってタグが置き換えられることになります。
[_user_login]
— このタグはユーザーのログイン名で置き換えられます。
[_user_email]
— このタグはユーザーのメールアドレスで置き換えられます。
[_user_url]
— このタグはユーザーのウェブサイト URL で置き換えられます。
[_user_first_name]
— このタグはユーザーの名前で置き換えられます。
[_user_last_name]
— このタグはユーザーの姓で置き換えられます。
[_user_nickname]
— このタグはユーザーのニックネームで置き換えられます。
[_user_display_name]
— このタグはユーザーの表示名で置き換えられます。