☰
WORDPRESS / PRACTICE

Як керувати автоматичним масштабуванням великих зображень у WordPress

Як керувати автоматичним масштабуванням великих зображень у WordPress

WordPress може автоматично зменшувати надто великі зображення під час завантаження. Для такого файлу створюється копія із суфіксом `-scaled`, і саме її система зазвичай використовує як основне зображення в медіаданих.

Це зменшує навантаження на сайт і прискорює роботу редактора, але не завжди підходить для фотографій, які використовуються в друці, zoom-галереях, каталогах товарів або на ретина-дисплеях. Поріг масштабування можна налаштувати через фільтр WordPress, а за потреби — повністю вимкнути.

Що саме робить WordPress із великим зображенням

Під час завантаження WordPress перевіряє розміри растрового зображення. Якщо його найбільша сторона перевищує встановлений поріг, система створює зменшену версію та додає до назви суфікс `-scaled`. Наприклад, для файлу `photo.jpg` може з’явитися `photo-scaled.jpg`.

У метаданих вкладення основним файлом стає масштабована версія. Тому користувач або шаблон сайту може отримувати не той файл, який був завантажений спочатку, а його зменшену копію. Водночас початковий файл часто залишається у файловій системі, але WordPress уже не використовує його як основне джерело для цього вкладення.

Масштабування відбувається до або під час створення похідних розмірів: мініатюр, середніх зображень та інших варіантів, які генерує тема або плагіни.

  • зменшується розмір файлу, який віддається сайту;
  • скорочується час обробки зображень у браузері;
  • зменшується ризик надмірного навантаження під час генерації похідних розмірів;
  • може втрачатися деталізація, потрібна для друку, кадрування або збільшення.

Коли автоматичне масштабування варто залишити

Для більшості контентних сайтів обмеження розміру — корисна функція. Камера або смартфон можуть створювати фотографії з дуже великою роздільною здатністю, хоча на сайті вони відображаються в невеликому блоці. Зберігати та обробляти такий оригінал для кожної сторінки зазвичай немає практичної потреби.

Автоматичний поріг особливо доречний для блогів, новинних сайтів, корпоративних сторінок і проєктів, де зображення використовуються лише на екрані. Він допомагає уникати випадкового завантаження файлів, які займають багато місця та змушують PHP довго генерувати thumbnails.

Водночас масштабування не замінює оптимізацію зображень. Воно змінює розміри, але не обов’язково оптимально стискає JPEG, PNG або WebP. Для повного контролю можуть знадобитися правильний формат, стиснення та адаптивна видача зображень.

  • залишайте обмеження, якщо редактори регулярно завантажують фото зі смартфонів або камер;
  • перевірте вимоги теми, галереї та плагінів до максимальної ширини;
  • не орієнтуйтеся лише на роздільну здатність: важливі також формат, якість стиснення та кількість похідних файлів.

Як змінити поріг масштабування через MU-плагін

Для керування порогом зручно використати must-use plugin — MU-плагін. Він завантажується автоматично та не залежить від перемикача звичайних плагінів у панелі керування.

Створіть каталог `wp-content/mu-plugins`, якщо його ще немає. Потім створіть у ньому файл, наприклад `image-threshold.php`, і додайте фільтр:

  • значення вказується в пікселях;
  • WordPress порівнює з ним найбільшу сторону зображення — ширину або висоту;
  • фільтр впливає на нові завантаження, а не автоматично на вже наявні файли.
<?php
add_filter( 'big_image_size_threshold', function ( $threshold ) {
    return 3000; // максимальна сторона у пікселях
} );

Як вибрати значення

Поріг 3000 пікселів означає, що зображення з шириною або висотою понад 3000 пікселів може бути масштабоване. Це не означає, що кожне зображення буде примусово збільшене до 3000 пікселів: менші файли залишаться без такого масштабування.

Значення потрібно узгодити з реальною шириною контенту, вимогами каталогу та сценаріями використання. Для сайту з великими банерами або детальними товарними фото поріг може бути вищим, ніж для звичайного блогу.

  • не встановлюйте надто низький поріг, якщо потрібне кадрування або збільшення фото;
  • не ставте дуже велике значення без перевірки дискового простору та часу обробки;
  • після зміни завантажте тестовий файл, який гарантовано перевищує новий поріг.

Як повністю вимкнути автоматичне масштабування

Якщо сайт повинен зберігати завантажене зображення в початковому розмірі, фільтр може повертати `false`. Це вимикає автоматичне масштабування великих зображень:

  • оригінальний розмір буде доступний WordPress як основний для нового вкладення;
  • похідні розміри все одно можуть створюватися темою або плагінами;
  • вимкнення не стискає та не оптимізує вже завантажені файли.
<?php
add_filter( 'big_image_size_threshold', '__return_false' );

Коли вимкнення виправдане

Такий варіант має сенс для фотостоків, портфоліо фотографів, сайтів із професійними галереями, друкованих матеріалів або магазинів, де відвідувачі повинні розглядати деталі товару.

Для звичайного сайту повне вимкнення без додаткових обмежень може створити більше проблем, ніж вирішити. Великі файли займають місце, довше обробляються та можуть збільшити навантаження на сервер під час масового імпорту медіа.

  • переконайтеся, що на сервері достатньо дискового простору;
  • перевірте ліміти пам’яті PHP та можливості графічного редактора;
  • домовтеся з редакторами про допустимі розміри та формати файлів.

Що зміниться після встановлення фільтра

Фільтр застосовується під час обробки нового завантаження. Якщо змінити поріг сьогодні, WordPress не перегенерує автоматично вже завантажені зображення та не видалить старі файли із суфіксом `-scaled`.

Для наявних медіафайлів потрібно окремо вирішити, чи потрібна регенерація похідних розмірів. Це можна робити інструментами або плагінами, які ви вже використовуєте для регенерації thumbnails, але перед масовою операцією варто створити резервну копію та перевірити результат на копії сайту.

Не видаляйте файли `-scaled` вручну одразу після зміни налаштування. На них можуть посилатися записи в базі даних, кеш або контент сторінок. Спочатку визначте, які файли реально використовуються.

  • перевірте новий файл у бібліотеці медіа та на сторінці, де він виводиться;
  • подивіться URL зображення: він допоможе зрозуміти, чи використовується `-scaled`;
  • переконайтеся, що галерея, zoom і lightbox працюють із потрібною версією;
  • перевірте резервне копіювання перед масовою регенерацією або очищенням.

Типові помилки та перевірка після налаштування

Найпоширеніша помилка — редагування файлів теми замість MU-плагіна. Після оновлення або зміни теми такий код можна втратити. Інша проблема — неправильне розуміння порогу: він стосується найбільшої сторони, а не площі зображення та не лише його ширини.

Також варто враховувати кеш. Якщо сторінка або CDN зберегли стару версію зображення, зміни можуть бути непомітними одразу. Для перевірки використовуйте нове тестове ім’я файлу, очистіть відповідний кеш і перегляньте зображення в режимі без кешу.

Якщо MU-плагін не працює, перевірте шлях до файлу, синтаксис PHP, права доступу та журнали помилок. У каталозі `mu-plugins` WordPress зазвичай підхоплює PHP-файли без додаткової активації.

  • завантажте зображення, яке перевищує встановлений поріг;
  • перевірте наявність або відсутність файлу з суфіксом `-scaled`;
  • порівняйте фактичні розміри оригіналу та файлу, який використовує медіавкладення;
  • відкрийте зображення у фронтенді, галереї та в повнорозмірному перегляді;
  • перевірте використання диска та час обробки після зміни налаштування.

Поширені запитання

Чи видаляє WordPress оригінальне зображення після створення файлу `-scaled`?

Не обов’язково. Масштабована копія стає основним файлом у метаданих вкладення, а початковий файл може залишатися на диску. Не видаляйте його вручну, доки не перевірите посилання та використання медіафайла.

Чи впливає `big_image_size_threshold` на вже завантажені зображення?

Ні. Фільтр застосовується під час нового завантаження або окремої повторної обробки. Старі файли автоматично не перегенеровуються.

Чи зникне суфікс `-scaled`, якщо підвищити поріг?

Для нових файлів, які не перевищують новий поріг, масштабована версія не створюватиметься. Уже наявні файли з `-scaled` самостійно не перейменуються та не видаляться.

Чи достатньо вимкнути масштабування для якісної галереї?

Ні. Потрібно також перевірити якість стиснення, формати, адаптивні розміри, налаштування галереї та роботу zoom. Вимкнення порогу лише зберігає великий файл як основний.

Висновок

Автоматичне масштабування великих зображень у WordPress — не помилка, а компроміс між якістю, швидкістю та використанням ресурсів. Для більшості сайтів краще залишити контрольований поріг, а не безумовно вимикати функцію.

Якщо бізнес-сценарій вимагає повнорозмірних оригіналів, змініть `big_image_size_threshold` через MU-плагін, протестуйте нові завантаження та окремо продумайте зберігання, резервні копії й регенерацію старих медіафайлів.

← Усі матеріали WordPress