wp_editor_set_quality │ хук-фильтр │ WP 3.5.0

Позволяет изменить стандартное качество сжатия изображения с учётом его MIME-типа и размеров.

В редакторе изображений применяется при инициализации или вызове WP_Image_Editor::set_quality() без указания качества. Явно переданное в метод значение имеет приоритет над фильтром.

При клиентской обработке изображений WordPress также применяет фильтр отдельно для каждого создаваемого размера и передаёт полученное качество браузеру.

Использование

add_filter( 'wp_editor_set_quality', 'wp_kama_editor_set_quality_filter', 10, 3 );

/**
 * Function for `wp_editor_set_quality` filter-hook.
 * 
 * @param int    $quality   Quality level between 1 (low) and 100 (high).
 * @param string $mime_type Image mime type.
 * @param array  $size      Dimensions of the image.
 *
 * @return int
 */
function wp_kama_editor_set_quality_filter( $quality, $mime_type, $size ){
	// filter...
	return $quality;
}

$quality(int)

Стандартное качество сжатия от 1 - минимальное, до 100 - максимальное.

$mime_type(string)

MIME-тип выходного изображения. Например, image/jpeg, image/webp или image/avif.

$size(array)

Размер выходного изображения.

• width(int)
  Ширина в пикселях.

• height(int)
  Высота в пикселях.

Примеры

#1 Уменьшение качества небольших JPEG-изображений

Устанавливает качество 60 для JPEG-изображений шириной меньше 300 пикселей.

add_filter( 'wp_editor_set_quality', 'kama_set_small_jpeg_quality', 10, 3 );

function kama_set_small_jpeg_quality( $quality, $mime_type, $size ) {
	if (
		'image/jpeg' === $mime_type
		&& isset( $size['width'] )
		&& $size['width'] <= 300
	) {
		return 60;
	}

	return $quality;
}

#2 Разное качество для каждого формата

Устанавливает отдельное качество для JPEG, WebP и AVIF.

add_filter( 'wp_editor_set_quality', 'kama_set_image_quality_by_format', 10, 3 );

function kama_set_image_quality_by_format( $quality, $mime_type, $size ) {
	$quality_by_format = [
		'image/jpeg' => 82,
		'image/webp' => 78,
		'image/avif' => 55,
	];

	return $quality_by_format[ $mime_type ] ?? $quality;
}