wordpress / latest / hooks / image_resize_dimensions.html

apply_filters( 'image_resize_dimensions', null|mixed $null, int $orig_w, int $orig_h, int $dest_w, int $dest_h, bool|array $crop )

Filters whether to preempt calculating the image resize dimensions.

Description

Returning a non-null value from the filter will effectively short-circuit image_resize_dimensions() , returning that value instead.

Parameters

$null null|mixed
Whether to preempt output of the resize dimensions.
$orig_w int
Original width in pixels.
$orig_h int
Original height in pixels.
$dest_w int
New width in pixels.
$dest_h int
New height in pixels.
$crop bool|array
Whether to crop image to specified width and height or resize.
An array can specify positioning of the crop area. Default false.

More Information

  • Since version 3.4, the image_resize_dimensions filter is used to filter the thumbnail and alternative sizes dimensions of image assets during resizing operations. This enables the override of WordPress default behavior on image resizing, including the thumbnail cropping.
  • Note that the filter function must return an array matching the parameters to imagecopyresampled(), or false if the resizing is impossible, or should not occur, or null to fallback to WordPress default behavior.

Source

File: wp-includes/media.php. View all references

$output = apply_filters( 'image_resize_dimensions', null, $orig_w, $orig_h, $dest_w, $dest_h, $crop );

Changelog

Version Description
3.4.0 Introduced.

© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/image_resize_dimensions