apply_filters( 'wpforms_html_field_value', string $value, array $field, array $form_data, string $context );

説明

wpforms_html_field_value フィルターは、さまざまな場所でエントリーフィールドの値に適用されます。エントリー値の表示時に、フィールド値をより視覚的にするために使用されます。

パラメーター

$value

(string) 値。

$field

(array) フィールド。

$form_data

(配列)  後で使用するために処理および準備されたフォーム設定/データ。

$context

(string) コンテキストの使用法。

ソース

wpforms/pro/includes/admin/entries/class-entries-single.php

詳細情報

このフィルターは、データベースに保存されている純粋なHTML値だけでなく、Entries リストにより視覚的なグラフィックを表示するために使用されます。

例

この例では、エントリー内にフィールドの説明を含めたいと思います。

/**
 * Filter used to convert a given entry value to a more robust visual format.
 *
 * In this example, if a hex color code is given in a text value, it's converted
 * to a link to view more details about the color.
 *
 * @link  https://wpforms.com/developers/wpforms_html_field_value/
 *
 * @param  string  $value      The value.
 * @param  array   $field      The field.
 * @param  array   $form_data  Processed form settings/data, prepared to be used later.
 * @param  string  $context    Context usage.
 *
 * @return string 
 */

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 . '<br><br>' . $field_data[ 'description' ];
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );

参考記事

• フォームエントリを表示する方法
• メール通知でアイテム価格の値を非表示にする方法
• メール通知にフィールドの説明を含める方法
• メール通知で電話番号をリンクにする方法
• チェックボックスの値を配列として保存する方法