Welcome!

• Move quickly so we can cover lots of good content… but don’t be shy about asking questions!

File Renamer Demo

History

• Started off as a snippet.
  • https://gravitywiz.com/rename-uploaded-files-for-gravity-form/
  • Published Dec 1, 2014 – 8 years ago!
• Lots of improvements over the years.

Perk

What can it do?

Three highlights:

1. Add prefix/suffix to filenames.

   • Or identifying information like user’s first and last name.

2. Organize files into folders.

   • Put all of an entry’s files into a folder based on the entry ID.
   • Put all of a user’s files into one folder across all entries.

     • Works with gform_upload_path filter!

       add_filter( 'gform_upload_path', function ( $path_info, $form_id ) {
       	$path_info['path'] = WP_CONTENT_DIR . '/secret/path/';
       	$path_info['url'] = WP_CONTENT_URL . '/secret/path/';
       	return $path_info;
       }, 10, 2 );
       

3. Works with File Upload Pro, Unique ID, and Media Library.

   • And with all core File Upload field types including the Post Image field.

What’s new in the perk version?

Three highlights:

1. Finally has a UI!

   • No more mucking about in the code (unless you want to 😉).
   • Full merge tag support for crafting the perfect filename template.

2. Support for incrementing filenames based on the order they were uploaded via the {i} template merge tag.

   Template: 
   
     {i}-{filename}
   
   Results:
   
   	1-wizard.png
   	2-magic.png
   	3-wand.png
   

   • This is per field.

3. The gpfr_filename gives magic powers!

   • Lowercase all filenames.

     add_filter( 'gpfr_filename', function( $renamed_file, $file, $entry ) {
     	return strtolower( $renamed_file );
     }, 10, 3 );
     

   • Apply a global filename template.

     add_filter( 'gpfr_filename', function( $renamed_file, $file, $entry ) {
     	$renamed_file = gp_file_renamer()->rename_file( $file, '{entry:id}/{filename}-{i}', $entry );
     	return $renamed_file;
     }, 10, 3 );
     

Mastering the Map Field

• First, here’s quick overview of the Map field and how it works.