### [メール通知にフィールドの説明を含める方法](https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/)
**公開日:** 2020年4月10日
**著者:** エディトリアルチーム
**抜粋:** このチュートリアルでは、PHPを使用してフィールドの説明がメール通知に含まれるようにする方法を説明します。
**コンテンツ:**
メール通知にフィールドの説明を含めたいですか？デフォルトでは、**{all\_fields}** には、説明を除き、フォームから入力されたすべてのフォームフィールドとラベルが含まれます。ただし、簡単なPHPスニペットを使用すると、メール通知に説明を簡単に追加できます。このチュートリアルでは、これを達成するための各ステップを順を追って説明します。
これらのスニペットは、**プレーンテキスト**のメールテンプレートを選択している場合は機能しないことに注意してください。
## フォームの作成
まず、フォームを作成する必要があります。フォームにはいくつかのフィールドが含まれ、1つのフィールドにのみ**フィールドの説明**が入力されます。
フォームを作成したら、メール通知に含めたいフィールドの説明を完成させてください。
フォームの作成についてサポートが必要な場合は、[このドキュメントをご覧ください](https://wpforms.com/docs/creating-first-form/ "最初のフォームの作成")。
## メールテンプレートの選択
このチュートリアルでは、**プレーンテキスト**のメールテンプレートが選択されていないことを確認する必要があります。どの設定が選択されているかわからない場合や、この設定について不明な場合は、[このドキュメントを確認して、このオプションを変更する場所を確認できます](https://wpforms.com/docs/a-complete-guide-to-wpforms-settings/#email "WPForms設定の完全ガイド")。
## 通知にフィールドの説明を含める
次に、スニペットをサイトに追加します。スニペットをサイトに追加する方法についてサポートが必要な場合は、[このチュートリアルをご覧ください](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/ "WPForms用のカスタムPHPまたはJavaScriptの追加方法")。
```
/*
* メール通知にフィールドの説明を含めます。
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
if ( $context !== 'email-html' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ] . '';
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
このスニペットを追加すると、フィールドの説明がすべてのメール通知に含まれるようになります。
これで完了です！メール通知にフィールドの説明を含めることができました。画像選択を通知メールに非表示にしたいですか？[通知メールで画像選択を非表示にする方法](https://wpforms.com/developers/how-to-hide-image-choices-in-notification-emails/ "通知メールで画像選択を非表示にする方法")の記事をご覧ください。
## 参照フィルター
[wpforms\_html\_field\_value](https://wpforms.com/developers/wpforms_html_field_value/ "wpforms_html_field_valueフィルターの使用")
## FAQ
#### Q: 通知のフィールドの説明をスタイル設定できますか？
**A:**このスニペットを使用して、フィールドの説明にCSSスタイルを追加できます。
```
/*
* メール通知にフィールドの説明を含めます。
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
if ( $context !== 'email-html' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ] . '';
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
#### Q: フォームIDごとに1つのフォームのみを対象にできますか？
**A:**もちろんです！1つのフォームのみでこれを行いたい場合は、このスニペットを使用してください。
```
/*
* メール通知にフィールドの説明を含めます。
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
// フォームID 780でのみこれを処理します
if ( $form_data[ 'id' ] !== '780' ) {
return $field_val;
}
if ( $context !== 'email-html' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ] . '';
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
スニペットの**780**を自分のフォームIDに合わせて置き換える必要があります。フォームIDの見つけ方がわからない場合は、[このチュートリアルをご覧ください](https://wpforms.com/developers/how-to-locate-form-id-and-field-id/ "フォームIDとフィールドIDの特定方法")。
#### Q: フィールドの説明をエントリーに追加するにはどうすればよいですか？
**A:**このスニペットをサイトに追加することで、フォームエントリーを表示する際にフィールドの説明を含めることができます。
```
/*
* フォームエントリーにフィールドの説明を含めます。
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
if ( $context !== 'entry-single' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ];
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
`entry-single`を使用することで、単一のエントリーを表示する際にフィールドの説明を表示できます。このスニペットを現在の表示中のエントリーに適用しても、フィールドの説明はすべてのエントリーに永続的に保存されるわけではありません。
#### Q: すべてではなく、特定のフィールドの説明のみを追加できますか？
**A:**もちろんです！この例では、**名前**フィールドの説明のみを含めます。
```
/*
* フォームエントリーにフィールドの説明を含めます。
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
if ( $context !== 'email-html' ) {
return $field_val;
}
if ( $field['type'] !== 'name' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][$field[ 'id' ]] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][$field[ 'id' ]];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ];
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
**カテゴリー:** 通知
**タグ:** PHP
---