☰
WORDPRESS / PRACTICE

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

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

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

Это снижает нагрузку на сайт и ускоряет работу редактора, но не всегда подходит для фотографий, используемых в печати, zoom-галереях, каталогах товаров или на Retina-дисплеях. Порог масштабирования можно настроить с помощью фильтра 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