gform_postimage_file

Description

The gform_postimage_file filter is executed when creating the Post Image File field and can be used to modify the “File” label.

Usage

Applies to all forms.

add_filter( 'gform_postimage_file', 'your_function_name', 10, 2 );

To target a specific form, append the form id to the hook name. (format: gform_postimage_file_FORMID)

add_filter( 'gform_postimage_file_5', 'your_function_name', 10, 2 );

Parameters

ParameterTypeDescription
$labelstringThe label to be filtered.
$form_idintegerThe current form’s id.

Examples

Change the Post Image File Label

This example changes the default Post Image File label:

add_filter( 'gform_postimage_file', 'change_postimage_file', 10, 2 );
function change_postimage_file( $label, $form_id ) {
	return 'Image File';
}

Placement

This code can be used in the functions.php file of the active theme, a custom functions plugin, a custom add-on, or with a code snippets plugin.

See also the PHP section in this article: Where Do I Put This Code?

Source Code

This filter is located in GF_Field_Post_Image::get_field_input() in includes/fields/class-gf-field-post-image.php.