add_image_size

Advertisement

Summery Summery

Image for: #Summery Summery

Register a new image size.

Syntax Syntax

Image for: #Syntax Syntax
add_image_size( string $name, int $width, int $height, bool|array $crop = false )

Parameters Parameters

Image for: #Parameters Parameters
$name

(Required) Image size identifier.

$width

(Optional) Image width in pixels. Default 0.

$height

(Optional) Image height in pixels. Default 0.

$crop

(Optional) Image cropping behavior. If false, the image will be scaled (default), If true, image will be cropped to the specified dimensions using center positions. If an array, the image will be cropped using the array to specify the crop location. Array values must be in the format: array( x_crop_position, y_crop_position ) where: - x_crop_position accepts: 'left', 'center', or 'right'. - y_crop_position accepts: 'top', 'center', or 'bottom'.

Default value: false

Source Source

Image for: #Source Source

File: wp-includes/media.php

function add_image_size( $name, $width = 0, $height = 0, $crop = false ) {
	global $_wp_additional_image_sizes;

	$_wp_additional_image_sizes[ $name ] = array(
		'width'  => absint( $width ),
		'height' => absint( $height ),
		'crop'   => $crop,
	);
}

Advertisement

Changelog Changelog

Image for: #Changelog Changelog
Changelog
VersionDescription
2.9.0Introduced.
Image for: #Related Related

Advertisement

Leave a Reply