Wrapper for _wp_handle_upload() .

Passes the ‘wp_handle_sideload’ action.

• _wp_handle_upload()

$file array Required

Reference to a single element of $_FILES.
Call the function once for each uploaded file.
See _wp_handle_upload() for accepted values.

More Arguments from _wp_handle_upload( ... $file )

Reference to a single element from $_FILES. Call the function once for each uploaded file.

• namestring
  The original name of the file on the client machine.
• typestring
  The mime type of the file, if the browser provided this information.
• tmp_namestring
  The temporary filename of the file in which the uploaded file was stored on the server.
• sizeint
  The size, in bytes, of the uploaded file.
• errorint
  The error code associated with this file upload.

$overrides array|false Optional

An associative array of names => values to override default variables.
See _wp_handle_upload() for accepted values.

More Arguments from _wp_handle_upload( ... $overrides )

An array of override parameters for this file, or boolean false if none are provided.

• upload_error_handlercallable
  Function to call when there is an error during the upload process.
  @see wp_handle_upload_error() .
• unique_filename_callbackcallable
  Function to call when determining a unique file name for the file.
  @see wp_unique_filename() .
• upload_error_stringsstring[]
  The strings that describe the error indicated in $_FILES[{form field}]['error'].
• test_formbool
  Whether to test that the $_POST['action'] parameter is as expected.
• test_sizebool
  Whether to test that the file size is greater than zero bytes.
• test_typebool
  Whether to test that the mime type of the file is as expected.
• mimesstring[]
  Array of allowed mime types keyed by their file extension regex.

Default: false

$time string Optional

Time formatted in 'yyyy/mm'.

Default: null

array See _wp_handle_upload() for return value.

File: wp-admin/includes/file.php. View all references

function wp_handle_sideload( &$file, $overrides = false, $time = null ) {
	/*
	 *  $_POST['action'] must be set and its value must equal $overrides['action']
	 *  or this:
	 */
	$action = 'wp_handle_sideload';
	if ( isset( $overrides['action'] ) ) {
		$action = $overrides['action'];
	}

	return _wp_handle_upload( $file, $overrides, $time, $action );
}