Scale down an image to fit a particular size and save a new copy of the image.

Description

The PNG transparency will be preserved using the function, as well as the image type. If the file going in is PNG, then the resized image is going to be PNG. The only supported image types are PNG, GIF, and JPEG.

Some functionality requires API to exist, so some PHP version may lose out support. This is not the fault of WordPress (where functionality is downgraded, not actual defects), but of your PHP version.

See also

• wp_get_image_editor()

Parameters

$filestringrequired

Image file path.

$max_wintrequired

Maximum width to resize to.

$max_hintrequired

Maximum height to resize to.

$cropbooloptional

Whether to crop image or resize.

Default:false

$suffixstringoptional

File suffix.

Default:null

$dest_pathstringoptional

New image file path.

Default:null

$jpeg_qualityintoptional

Image quality percentage.

Default:90

Return

Source

function image_resize( $file, $max_w, $max_h, $crop = false, $suffix = null, $dest_path = null, $jpeg_quality = 90 ) {
	_deprecated_function( __FUNCTION__, '3.5.0', 'wp_get_image_editor()' );

	$editor = wp_get_image_editor( $file );
	if ( is_wp_error( $editor ) )
		return $editor;
	$editor->set_quality( $jpeg_quality );

	$resized = $editor->resize( $max_w, $max_h, $crop );
	if ( is_wp_error( $resized ) )
		return $resized;

	$dest_file = $editor->generate_filename( $suffix, $dest_path );
	$saved = $editor->save( $dest_file );

	if ( is_wp_error( $saved ) )
		return $saved;

	return $dest_file;
}

View all references View on Trac View on GitHub

Changelog