add_image_size() │ WP 2.9.0

Реєструємо нові розміри мініатюр, додавши такий код файл шаблону functions.php:

if ( function_exists( 'add_theme_support' ) ) {

	// розмір мініатюри посту за умовчанням
	add_theme_support( 'post-thumbnails');
	set_post_thumbnail_size(150, 150);

}

if ( function_exists( 'add_image_size' ) ) {

	// 300 завширшки і без обмеження заввишки
	add_image_size ( 'category-thumb', 300, 9999);

	// Кадрування зображення
	add_image_size( 'homepage-thumb', 220, 180, true);
}

Масштабування$crop = false

Цей рядок вкаже WP, що при завантаженні нового файлу потрібно створити його зменшену копію. В цьому випадку мініатюра буде підігнана під ширину або висоту, дивлячись яка зі сторін підходить більше, а протилежна сторона буде зменшена пропорційно і швидше за все не буде більше вказаного розміру. Наприклад, у нас оригінал картинки 2500х1800 пікселів ми робимо мініатюру 220х180 пікселів. Картинка буде зменшена до розмірів – 250х180 px, тобто. висота буде 180, як ми і вказали, проте ширина вийде вище вказаної 250, а не 220. У цьому випадку картинка не кадрується і зменшена копія зберігає пропорції повністю.

add_image_size( 'homepage-thumb', 220, 180, false);

Кадрування$crop = true

Якщо встановити четвертий параметр в true, мініатюра буде зменшена і обрізана точно під зазначені розміри. Наприклад, у нас оригінал картинки 2500х1800 пікселів ми робимо мініатюру 220х180 пікселів. Оригінал буде зменшено до висоти 180xp (тоді ширина його рівна 250px), а ширина буде обрізана по краях по 15px і в результаті отримаємо зменшену копію: 220х180 пікселів:

add_image_size( 'homepage-thumb', 220, 180, true);

Кадрування із зазначенням позицій$crop = [ x, y ]

З версії 3.9 виникла можливість вказувати позицію кадрування. Давайте додамо розмір мініатюри, яка буде розміром 220х220 пікселів та буде фрагментом від оригіналу, який буде взято з лівого верхнього кута (left, top):

add_image_size('custom-size', 220, 220, ['left', 'top']);

Х_позиція може бути: ‘ left ‘ ‘ center ‘ або ‘ right ‘.
Y_позиція може бути: ‘ top ‘, ‘ center ‘ або ‘ bottom ‘.

Щоб зменшити картинку по одній із потрібних нам сторін, потрібно вказати протилежному боці велике значення. Наприклад, у нас є картинка 2500х1800, нам потрібно отримати мініатюру 500х1800, тоді вказуємо так:

add_image_size( 'homepage-thumb', 500, 9999);

Ми зареєстрували 3, відмінні від базових, розміру: post-thumbnails, category-thumb, homepage-thumb. Щоб тепер використовувати ці розміри (виводити картинки у шаблоні), можна використовувати такі функції:

Вибране зображення (featured image)

Щоб використовувати новий розмір при виведенні картинки встановленої як “Вибране зображення” посту, у файлі шаблону потрібно використовувати функцію the_post_thumbnail() :

if ( has_post_thumbnail() ) {
	the_post_thumbnail( 'category-thumb'); // category-thumb – назва розміру
}

Новий розмір на вибір розмірів при вставці картинки (адмін-панель)

Щоб додати новий розмір у вибір розмірів при вставці картинки в пост, потрібно використовувати фільтр-хук image_size_names_choose, в якому потрібно додати розмір і вказати для нього зрозумілу назву:

add_filter( 'image_size_names_choose', 'my_custom_sizes');
function my_custom_sizes( $sizes ) {
	return array_merge( $sizes, array(
		'category-thumb' => 'Мій розмірник',
	)));
}

Для основних медіафайлів (PHP/Templates)

Також можна виводити картинки (за розмірами) безпосередньо з бібліотеки WordPress за ID зображення. Для цього використовуйте функцію wp_get_attachment_image() :

// Маю на увазі, що у вас у бібліотеці є картинка з ID 42...
echo wp_get_attachment_image(42, 'category-thumb');

Якщо нам потрібно отримати тільки УРЛ картинки, а не готовий тег <img>, то використовуйте функцію wp_get_attachment_image_src() .