Превью нарезаются один раз — при загрузке фото в админке (и при перегенерации). На сайт отдаются готовые файлы, сервер не обрабатывает картинки на каждом просмотре. Обработка — библиотека Glide.
Размеры превью
Размеры задаются в источнике файлов: Медиа → Источники файлов → «Gallery3x Source» → Свойства, параметр gallery3x_thumbnails — JSON-массив, по объекту на размер. После установки там:
[
{"name": "small", "w": 120, "h": 90, "q": 90, "fit": "crop"},
{"name": "medium", "w": 360, "h": 270, "q": 100, "fit": "crop"},
{"name": "big", "w": 1200}
]| Ключ | Описание |
|---|---|
name | Обязательно. Имя размера: папка превью и плейсхолдер [[+имя_url]] ([[+small_url]], [[+big_url]]). |
w, h | Ширина и высота, px. Можно указать одно из двух — второе по пропорциям. |
fit | Как вписать в w×h (см. ниже). |
q | Качество 0–100 (для jpg, webp, avif). По умолчанию 90. |
fm | Формат этого размера. Если задана настройка gallery3x.format, действует она. |
| другие | Любые параметры Glide: sharp, blur, bg, flip, or и т.д. |
Значения fit
| fit | Результат |
|---|---|
contain | По умолчанию. Вписать целиком с сохранением пропорций; итоговый размер может быть меньше w×h по одной стороне. |
max | Как contain, но не увеличивать изображение меньше заданного размера. |
fill | Вписать целиком и дополнить до w×h фоном (цвет — параметр bg). |
stretch | Растянуть точно до w×h без сохранения пропорций. |
crop | Заполнить w×h и обрезать лишнее; точка обрезки — crop-top-left, crop-top, crop-center (по умолчанию), crop-bottom-right и т.д. или crop-25-75 (фокус в процентах). |
Общие настройки обработки
В системных настройках (пространство имён gallery3x) — для всех размеров сразу:
gallery3x.format— формат всех превью (по умолчаниюwebp; пусто — как у оригинала). Оригинал не конвертируется.gallery3x.filters— эффекты через|:greyscale,sepia,blur=10,pixel=5,bri=10(яркость −100…100),con=-5(контраст),gam=1.5,sharp=15. Пример:sepia|bri=10|con=-5.gallery3x.watermark_path,gallery3x.watermark_position,gallery3x.watermark_padding— водяной знак на всех превью (оригинал без знака).gallery3x.driver—imagickилиgd.
Разные размеры для разных разделов
Создайте ещё один источник файлов со своим gallery3x_thumbnails и привяжите его к шаблонам настройкой gallery3x.source_map, например 12,14:5 — ресурсы с шаблонами 12 и 14 хранят фото в источнике 5.
После изменения настроек
Уже загруженные превью сами не меняются. Перегенерируйте их: в админке — правой кнопкой по фото → «Перегенерировать превью» (можно для выделенных), для всего сайта — консольным скриптом regenerate.php.
Промежуточные файлы Glide лежат в папке
.cacheвнутри источника; её можно очищать.