add_image_size() — описание функции WordPress на русском

Сигнатура

add_image_size( string $name, int $width, int $height, bool|array $crop = false )

Описание

Регистрирует новый размер изображения.

Параметры

$name string обязательный

Идентификатор размера изображения.

$width int необязательный

Ширина изображения в пикселях. Значение по умолчанию 0.

$height int необязательный

Высота изображения в пикселях. Значение по умолчанию 0.

$crop bool|array необязательный = false

Поведение при обрезке изображения. Если false, изображение будет масштабировано (по умолчанию). Если true, изображение будет обрезано до указанных размеров с центрированием. Если передан массив, изображение обрезается с использованием массива для указания места обрезки: 0 stringПозиция обрезки по оси x. Принимает 'left', 'center' или 'right'. 1 stringПозиция обрезки по оси y. Принимает 'top', 'center' или 'bottom'.

Исходный код

wp-includes/media.php:300

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,
	);
}

История изменений

Версия	Описание
2.9.0	Introduced.