add_image_size () - Реєструє новий розмір картинки (мініатюри). Функція WordPress.
- повертає
- Використання
- Зарезервовані назви розмірів
- приклади
- Кадрування (параметр $ crop)
- # 2 - true (кадрування)
- # 3 - зменшення по потрібної стороні
- # 4 - Array (x, y) (кадрування із зазначенням позицій)
- Використання нових розмірів
- Модулі
- список змін
- Код add image size: wp-includes / media.php WP 5.2.2
- cвязана функції
Реєструє новий розмір картинки (мініатюри).
Реєстрація означає, що WordPress, при завантаженні зображення, крім базових розмірів створюватиме ще один файл - змінену копію оригіналу з зазначеними розмірами.
Щоб для поста можна було визначити картинку мініатюру, потрібно активувати цю можливість функцією - add_theme_support ( 'post-thumbnails'); в файлі шаблону funсtions.php.
Щоб створювати мініатюри на льоту з будь-яким розміром, замість цієї функції, використовуйте мій плагін Kama Thumbnail .
При створенні своєї теми для каталогу тим ВП, назва нового розміру повинно містити ім'я теми, докладніше за посиланням . наприклад:
add_image_size ( 'mytheme-mini', 200, 200, true);
Хуков немає.
повертає
Нічого не повертає.
Використання
add_image_size ($ name, $ width, $ height, $ crop); $ name (рядок) (обов'язковий) Назва нового розміру картинок. $ width (число) (обов'язковий) Ширина мініатюри (в пікселях). $ height (число) (обов'язковий) Висота мініатюри (в пікселях). $ crop (логічний)
Як створювати мініатюру?
false - масштабування: картинка буде змінена в розмірі по підходящої стороні. Мініатюра створюється по одній з відповідних сторін: зазначеної ширині або висоті. Підсумкова картинка не буде точно збігатися зазначеними розмірами.
true - кадрування: мініатюра створюється точно по зазначених розмірах. Підбирається найбільш підходяща сторона, картинка зменшується по ній, а у протилежної сторони зайва частина, що не підходить по пропорціям обрізається.
- array (коордіната_X, коордіната_Y) - вказівка позиції кадрування, тобто якщо вказати масив (array ( 'right', 'top')), то зображення буде кадрувати з зазначених позицій.
crop працює тільки для новостворюваних картинок. Якщо на сайті вже є картинки і тільки потім додається розмір, то воно оброблені не будуть.
За замовчуванням: false
Зарезервовані назви розмірів
thumb, thumbnail, medium, large, post-thumbnail
Назви "thumb" і "thumbnail" - це аліаси (синоніми) і відносяться до однакових файлів.
Дивіться також опис функції image_downsize () .
Також ви можете задати параметри створюваної мініатюри через:
update_option ( 'thumbnail_size_w', 160); update_option ( 'thumbnail_size_h', 160); update_option ( 'thumbnail_crop', 1);
приклади
Додамо нові розміри мініатюр
Реєструємо нові розміри мініатюр, додавши такий код в файл шаблону 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')) {add_image_size ( 'category-thumb', 300, 9999); // 300 в ширину і без обмеження в висоту add_image_size ( 'homepage-thumb', 220, 180, true); // Обрізати зображення}
Кадрування (параметр $ crop)
# 1 - false (масштабування)
Цей рядок вкаже WP, що при завантаженні нового файлу, потрібно створити його зменшену копію. В цьому випадку мініатюра буде підігнана під ширину або висоту, дивлячись яка зі сторін підходить більше, а протилежна сторона буде зменшена пропорційно і швидше за все не буде більше зазначеного розміру. Наприклад, у нас оригінал картинки 2500х1800 пікселів ми робимо мініатюру 220х180 пікселів. Картинка буде зменшена до розмірів - 250х180 px, тобто висота буде 180, як ми і вказали, однак ширина вийде вище зазначеної 250 а не 220. У цьому випадку картинка не кадруються і зменшена копія зберігає пропорції повністю.
add_image_size ( 'homepage-thumb', 220, 180);
# 2 - true (кадрування)
Якщо встановити четвертий параметр в true, то мініатюра буде зменшена і обрізана точно під зазначені розміри. Наприклад, у нас оригінал картинки 2500х1800 пікселів ми робимо мініатюру 220х180 пікселів. Оригінал буде зменшений до висоти 180xp (тоді ширина його хіба що дорівнює 250px), а ширина буде обрізана по краях по 15px і в підсумку отримаємо зменшену копію: 220х180 пікселів:
add_image_size ( 'homepage-thumb', 220, 180, true);
# 3 - зменшення по потрібної стороні
Щоб зменшити картинку по одній з потрібних нам сторін, потрібно вказати протилежному боці величезне значення. Наприклад, у нас є картинка 2500х1800, нам потрібно отримати мініатюру 500х1800, тоді вказуємо так:
add_image_size ( 'homepage-thumb', 500, 9999);
# 4 - Array (x, y) (кадрування із зазначенням позицій)
З версії 3.9 з'явилася можливість вказувати позицію кадрування. Давайте додамо розмір мініатюри, яка буде розміром 220х220 пікселів і буде фрагментом від оригіналу, який буде взятий з лівого верхнього кута (left, top):
add_image_size ( 'custom-size', 220, 220, array ( 'left', 'top'));
Х_позіція може бути: 'left' 'center' або 'right'.
Y_позіція може бути: 'top', 'center' або 'bottom'.
Використання нових розмірів
Ми зареєстрували 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 () .
Модулі
Regenerate Thumbnails - цей плагін дозволяє створити нові розміри для кожного завантаженого зображення. Корисний коли ви змінили або додали нові розміри мініатюр (через Установки> Медіафайли) під час коли в бібліотеці вже є завантажені зображення. Або коли ви змінили розміри "Вибраного зображення" поста.
Force Regenerate Thumbnails - видаляє раніше створені розміри і створює нові, на основі поточних установок.
AJAX thumbnail rebuild - дозволяє перебудувати мініатюри. Корисний, якщо ви використовували функцію add_image_size () коли у вас вже є завантажені зображення. (Це повільний плагін, але при цьому в ньому не буває помилок з недоліком виділеної пам'яті).
- Simple Image Sizes - дозволяє створювати нові розміри мініатюр прямо з панелі "Медіафайли". Він також вміє пересоздавать мініатюри. Він додає нові розміри в вибір для постів, так ви можете вставляти нові розміри в пости. Ви можете вибирати які з розмірів ви б хотіли перебудувати і для яких типів постів це потрібно зробити.
-
Дуже вигідне SMM пропозицію можна отримати прямо зараз від сайту doctorsmm.com . На цьому сервісі Ви можете замовити будь-яку послугу по просуванню в 9 і більше соціальних мережах, а саме: накрутку лайків, передплатників, переглядів та ін. Ресурсів. Так Ви зможете швидко і безпечно розвинути свою сторінку і підняти її рейтинг в мережі. До того ж, на сайті діють значні оптові знижки.
список змін
З версії 2.9.0 Введена.
Код add image size: wp-includes / media.php WP 5.2.2
<? 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,); }