(action)_prefilter │ filter-hook │ WP 2.9.0

Filters the data for a file before it is uploaded to WordPress.

The dynamic portion of the hook name, $action, refers to the post action.

Possible hook names include:

• wp_handle_sideload_prefilter
• wp_handle_upload_prefilter

Usage

add_filter( '(action)_prefilter', 'wp_kama_action_prefilter' );

/**
 * Function for `(action)_prefilter` filter-hook.
 * 
 * @param array $file Reference to a single element from `$_FILES`.
 *
 * @return array
 */
function wp_kama_action_prefilter( $file ){

	// filter...
	return $file;
}

$file(array)

Reference to a single element from $_FILES.

• name(string)
  The original name of the file on the client machine.

• type(string)
  The mime type of the file, if the browser provided this information.

• tmp_name(string)
  The temporary filename of the file in which the uploaded file was stored on the server.

• size(int)
  The size, in bytes, of the uploaded file.

• error(int)
  The error code associated with this file upload.

Changelog

Where the hook is called

$file = apply_filters( "{$action}_prefilter", $file );

Where the hook is used in WordPress

add_filter( 'wp_handle_upload_prefilter', 'check_upload_size' );