DescriptionUsageParametersExamples1. Use an entry value in the filename.PlacementSource Code
Description
This filter can be used to override the filename before the file is uploaded to Dropbox.
Usage
The following would apply to all forms:
add_filter( 'gform_dropbox_file_name', 'your_function_name', 10, 5 );
To target a specific form append the form id to the hook name. (format: gform_dropbox_file_name_FORMID)
add_filter( 'gform_dropbox_file_name_10', 'your_function_name', 10, 5 );
Parameters
$file_name string
The filename, including extension, e.g. screenshot.png.
$form Form Object
The form currently being processed.
$field_id string
The ID of the field currently being processed.
$entry Entry Object
The entry currently being processed.
$feed Feed Object
The feed currently being processed.
Examples
1. Use an entry value in the filename.
This example shows how you can use a value from the Entry Object when modifying the filename.
add_filter( 'gform_dropbox_file_name_10', 'change_name', 10, 5 );
function change_name( $file_name, $form, $field_id, $entry, $feed ) {
return rgar( $entry, 'id' ) . '-' . $file_name;
}
Placement
This code should be placed in the functions.php file of your active theme.
Source Code
gf_apply_filters( 'gform_dropbox_file_name', $form['id'], $file['name'], $form, $field_id, $entry, $feed )
This filter is located in the following methods in class-gf-dropbox.php:
GFDropbox::upload_file()
GFDropbox::process_dropbox_fields()