Функция регистрирует новый размер изображения. Это означает, что каждый раз при загрузке новой картинки, WordPress будет создавать ее копию с указанными в параметрах размерами.
add_image_size( $name, $width = 0, $height = 0, $crop = false )
- $name
- (строка) название размера. Понадобится вам для использования в функциях, например таких, как wp_get_attachment_image_src() или the_post_thumbnail(). Нельзя использовать следующие зарезервированные названия:
thumb
,thumbnail
,medium
,large
,post-thumbnail
, - $width
- (целое число) ширина изображения в пикселях,
- $height
- (целое число) высота изображения в пикселях,
- $crop
- (логическое|массив) может принимать значения:
false
(по умолчанию) — изображение будет вписано в указанный размер с сохранением пропорций,true
— изображение будет точно такого же размера, который указан в параметрах, а то, что не поместится, будет обрезано;массив
(с версии WordPress 3.9) – об этом у меня есть отдельный урок.
Функция ничего не возвращает.
Пример
Добавим два размера изображений — один например для слайдера, другой — для превьюшек в категориях.
add_image_size( 'slider-image', 1600, 800, true ); add_image_size( 'category-thumbnails', 220, 500 );