Contact Form 7 File Upload Complete Details With Examples [2020]

[admin]

Contact form 7 file upload complete details with some other optional plugin also. It is describing, how to avoid not working issues not uploading issues etc.

Contact Form 7 file upload in a professional way. You can enable file attachment feature to your form. You will receive the attached file by email or you can store it in your server also by Contact Form 7 Database plugin.

Contact form 7 hook list

https://docs.wpdebuglog.com/

Contact form 7 File Upload (cf7 file upload) Shortcode Generator

Sample Shortcode (file upload example)

 

File Tag Options

OPTION	EXAMPLES	DESCRIPTION
id:(id)	id:some-id	id attribute form file input tag.
class:(class)	class:some-class-here	class: the attribute value of the input element.  One or more class is possible, like [file your-file class:col-md-2 class:m01 class:pt-1].
filetypes:(filetypes)	filetypes:gif|jpg|jpeg|png	Add acceptable file types after filetypes:   Multiple file types are separated with (pipe) ‘|’ character.
limit:(num)	limit:2043576 limit:3024kb limit:3mb	Maximum upload file size.  (i.e., like this: [file your-file limit:1.5mb])

Attach File to Mail

Just go to WP-admin > contact form 7 ( created form) > mail > file attachments add your file input tag as in image.

You can add more input field one by one like [your-image][your-image2] like that.  Mostly developer forgot to add file attachment tag to file attachment section. So Contact form 7 file attachment not sending or not receiving attachments is a common problem.

File Upload Validation

File type and size validations are inbuilt.  jpg, png,jpeg, gif, pdf, doc, docx, ppt, pptx, odt, avi, ogg, m4a, mov, mp3, mp4, mpg, wav, and wmv are default file extensions. Customize is possible just add filetypes: in the shortcode.

Example: [file your-file filetypes:png|jpeg] 

File type not allowed message will get ( you are not allowed to upload files of this type ) If we upload gif, zip or any other file type (in this example).

File upload size limit

1048576 bytes (1 MB) is the default file size limit. Customize file size with limit: option. The default number is in bytes but we can add by Mb or Kb. We can see an error message, “The file is too big” if we upload a file bigger than the limit.

Example : [file your-file limit:2Mb]

Image Upload Dimension Validation

CF7 image upload width and size validation code. Add filter for ‘wpcf7_validate_file‘ .

[file* your-image filetypes:gif|jpg|jpeg|png]

Add the following code in your theme functions.php file or custom plugin file.

Here minimum width and height is 300px.

PHP

add_filter( 'wpcf7_validate_file*', 'custom_cf7_file_validation_filter', 7, 2 ); add_filter( 'wpcf7_validate_file', 'custom_cf7_file_validation_filter', 7, 2 ); function custom_cf7_file_validation_filter( $result, $tag ) { //Change your-image (input field name) if ( 'your-image' == $tag->name ) { $name = $tag->name; $file = isset( $_FILES[$name] ) ? $_FILES[$name] : null; $minimum = array('width' => '300', 'height' => '300'); list($width, $height) = getimagesize( $file['tmp_name'] ); if ($width < $minimum['width']) { $result->invalidate( $tag, "Image dimension are to small. Minimum width is {$minimum['width']}px. Uploaded image width is $width px"); } elseif ($height < $minimum['height']) { $result->invalidate( $tag, "Image dimension are to small. Minimum height is {$minimum['height']}px. Uploaded image height is $height px"); } } return $result; }

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

add_filter( 'wpcf7_validate_file*', 'custom_cf7_file_validation_filter', 7, 2 ); add_filter( 'wpcf7_validate_file', 'custom_cf7_file_validation_filter', 7, 2 );   function custom_cf7_file_validation_filter( $result, $tag ) {      //Change your-image (input field name)     if ( 'your-image' == $tag->name ) { $name    = $tag->name; $file    = isset( $_FILES[$name] ) ? $_FILES[$name] : null; $minimum = array('width' => '300', 'height' => '300'); list($width, $height)     = getimagesize( $file['tmp_name'] );   if ($width < $minimum['width']) {             $result->invalidate( $tag, "Image dimension are to small. Minimum width is {$minimum['width']}px. Uploaded image width is $width px");         } elseif ($height <  $minimum['height']) {             $result->invalidate( $tag, "Image dimension are to small. Minimum height is {$minimum['height']}px. Uploaded image height is $height px");         }             }       return $result; }

 

Contact form 7 file upload not working?

Have you got an error message, “There was an unknown error uploading the file”?

We can fix it by following steps.

First step:

Check wp-content/uploads/wpcf7_uploads folder is writable (755 – 777 ) or not. It should writable folder.

Make sure your wpcf7_uploads should writable. For Linux and Mac OS, We can change folder permissions by the following command.

sudo chmod 755 wp-content/uploads/wpcf7_uploads

1	sudo chmod 755 wp-content/uploads/wpcf7_uploads

Please try with 777, if it is not working. But 777 is not good practice.

Second step:

Check your PHP maximum upload file size. We can check the maximum file upload size in wp-admin > Media > Add New , We can see “Maximum upload file size: (num) MB”. The maximum upload file size should greater than your upload file size (Contact form 7 file shortcode size).

Method 1: Change maximum upload size with a php.ini file

Add or change the upload_max_filesize, post_max_size, and memory_limit as bellow in the php.ini file.

upload_max_filesize = 20M post_max_size = 21M memory_limit = 15 max_execution_time = 300 max_input_time = 300

1 2 3 4 5

upload_max_filesize = 20M post_max_size = 21M   memory_limit = 15 max_execution_time = 300 max_input_time = 300

Now you can upload a maximum 20Mb file. You can change this value according to your needs.

Method 2: Change maximum file upload size with a .htaccess file 

Add the following lines of code in your root .htaccess file. You can add last part of your .htaccess file.

php_value upload_max_filesize 64M php_value post_max_size 128M php_value memory_limit 256M php_value max_execution_time 300 php_value max_input_time 300

1 2 3 4 5 6 7 8 9

php_value upload_max_filesize 64M   php_value post_max_size 128M   php_value memory_limit 256M   php_value max_execution_time 300   php_value max_input_time 300

Method 3: Change maximum file upload size with wp-config.php or selected theme functions.php file

Add the following line of codes in wp-config.php or theme functions.php file.

@ini_set( 'upload_max_size' , '64M' ); @ini_set( 'post_max_size', '64M'); @ini_set( 'max_execution_time', '300' );

1 2 3

@ini_set( 'upload_max_size' , '64M' ); @ini_set( 'post_max_size', '64M'); @ini_set( 'max_execution_time', '300' );

 

File Upload Path

By default wp-content/uploads/wpcf7_uploads is temporary upload file path. Files will delete immediately after few seconds. You can change the temporary folder name byWPCF7_UPLOADS_TMP_DIR  constant in wp-config.php.

define( 'WPCF7_UPLOADS_TMP_DIR', '/your/file/path' );

1	define( 'WPCF7_UPLOADS_TMP_DIR', '/your/file/path' );

How to save the attached file to the server?

Install the CF7 database plugin to your WordPress website. It is a free and popular plugin. You can see and download files in the admin dashboard. It allows downloading submissions as a CSV file. No need for any extra configuration. It is 100% automatic. You can contribute to improving the CFDB7 plugin. Fork it on GitHub and pull the request. [Github – CFDB7]

Get uploaded files by code

Save uploaded files by custom plugin or theme functions.php file. We can catch uploaded file by wpcf7_before_send_mail action hook and WPCF7_Submission class instance.  WPCF7_Submission class is a singleton class. It means it instantiates only one time. We can access as an object by get_instance() function. Check the following example code.

add_action('wpcf7_before_send_mail', 'save_application_form' ); function save_application_form($wpcf7) { $submission = WPCF7_Submission::get_instance(); $files = $submission->uploaded_files(); }

1 2 3 4 5 6

add_action('wpcf7_before_send_mail', 'save_application_form' );   function save_application_form($wpcf7) {     $submission = WPCF7_Submission::get_instance();     $files = $submission->uploaded_files(); }

We can copy for move uploaded the file by move_uploaded_file  PHP function before sent mail. This file will automatically delete after sent mail.

Customize file upload validation error messages

Go to contact form 7 form > messages tab. Then set the custom message in the input field.

 

Multiple File Upload

CF7 default plugin does not allow to upload multiple files. But some other paid plugins are available.

Drag and drop files upload input

Upload multiple files with drag and drop and preview option. [More Details]

Multiple file upload input

It is similar to default contact form 7 file upload shortcode but multiple file upload option is enabled. [More Details]

Field repeater plugin

Repeat input fields by clicking on the add button or remove by clicking on the remove button. [More Details]

 

Note:- Please share your contact form 7 bugs or anything related CF7 plugin. We can solve.

 

[silvio111086]

Hi,
what’s the best method to catch and concatenate in body message the complete URL of attached files?
Using Contact Form Submissions they are permanently stored in wp-content/uploads/wpcf7-submissions but I am not able to show it mail body

[admin]

@silvio111086 Contact form 7 not saving data to the folder (disk) permanently. You need to install cfdb7 plugin and custom plugin also. I can develop a custom plugin. Please feel free to PM.
Skype: arshidkv12

[Author]

Posts