wp_get_image_editor()
Returns a WP_Image_Editor instance and loads file into it.
No Hooks.
Returns
WP_Image_Editor|WP_Error
. The WP_Image_Editor object on success, a WP_Error object otherwise.
Usage
wp_get_image_editor( $path, $args );
- $path(string) (required)
- Path to the file to load.
- $args(array)
- Additional arguments for retrieving the image editor.
Default: empty array
Examples
#1 Create a thumbnail of the image
Let's assume we have an image '/wp-content/uploads/2014/02/uka.png' (it is on our server). This example shows how to create a reduced copy of this image using the WP_Image_Editor class:
$file_path = $_SERVER['DOCUMENT_ROOT'] . '/wp-content/uploads/2014/02/uka.png'; // load the object $image = wp_get_image_editor( $file_path ); // you can specify the URL instead of the absolute path: // $image = wp_get_image_editor( 'http://wp-kama.ru/wp-content/uploads/2014/02/uka.png' ); // process the image if ( ! is_wp_error( $image ) ) { // rotate the image by 90 degrees $image->rotate( 90 ); // resize it to 80x80 $image->resize( 80, 80, true ); // save in the same folder as the current file, with the name {name}-{suffix}.{ext} $new_file_path = $image->generate_filename(); // save in the root of the site as new_image.png $image->save( $new_file_path ); }
Changelog
Since 3.5.0 | Introduced. |