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 on Trac

Changelog

Version Description
3.4.0 Introduced.

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