Параметры phpThumbOn/pThumb в MODX Revolution

phpThumbOn (сейчас чаще используется форк pThumb) — это сниппет MODX для генерации уменьшенных копий изображений «на лету». Он создаёт превью, ресайз, кроп и применяет фильтры, сохраняя результат в кэше. Разберём параметры и реальные примеры.

Базовый синтаксис

Вызов сниппета:

/assets/cache_image/noimage_300,hx0_893.jpg

В современном проекте рекомендуют использовать pThumb (форк):

[[pthumb? &input=`[[+tv.image]]` &options=`w=600&h=400&zc=1&q=85`]]

Основные параметры

Параметр	Назначение	Пример
w	Ширина изображения (px)	w=300
h	Высота изображения (px)	h=200
q	Качество JPEG (1–100)	q=85
zc	Zoom Crop (обрезка с заполнением)	zc=1
far	Force Aspect Ratio (пропорции, bg fill)	far=C (по центру)
bg	Фон при подгонке (hex, RGB)	bg=ffffff
aoe	Allow enlargement (увеличивать исходник)	aoe=1
fltr[]	Фильтры (blur, gray, sharpen и др.)	fltr[]=gray

Примеры вызова

1. Простое уменьшение

[[pthumb? &input=`assets/img/logo.png` &options=`w=150&h=150&zc=1&q=90`]]

2. Уменьшение без кропа, с сохранением пропорций

[[pthumb? &input=`[[*tv.image]]` &options=`w=800&h=600&far=C&q=85`]]

3. Добавление фильтров

[[pthumb? 
  &input=`assets/img/banner.jpg` 
  &options=`w=1024&h=300&zc=1&q=80&fltr[]=gray&fltr[]=blur|10`
]]

Фильтры (fltr[])

Поддерживаются разные эффекты:

fltr[]=gray — чёрно-белое изображение
fltr[]=blur|10 — размытие
fltr[]=sepia — эффект сепии
fltr[]=usm|80|0.5|3 — повышение резкости

Работа с TV (изображения товаров, баннеры)

<img src="[[pthumb? &input=`[[+tv.image]]` &options=`w=400&h=300&zc=1`]]" alt="[[+pagetitle]]">

Кэширование

Сгенерированные превью сохраняются в assets/components/phpthumbon/cache/.
При изменении параметров создаётся новый файл (старые можно чистить вручную или скриптом).
В pThumb есть системные настройки для управления временем жизни кэша.

Советы по использованию

Не генерируйте слишком большие изображения «на лету» — используйте кэш.
Для адаптивных сайтов делайте несколько размеров превью и подключайте через srcset.
Старайтесь задавать q=80–85 для баланса «качество/вес».

Заключение

Дополнение phpThumbOn/pThumb — универсальный инструмент для ресайза и обработки изображений в MODX. С его помощью можно делать адаптивные превью, галереи, миниатюры товаров и баннеров, управляя качеством и фильтрами.

👉 Нужно внедрить адаптивные изображения и оптимизацию графики? Обратитесь за разработкой сайтов на MODX.

FAQ

В чём разница между phpThumbOn и pThumb?

phpThumbOn — оригинальный сниппет. pThumb — современный форк с оптимизациями и поддержкой Fenom, рекомендуется для новых проектов.

Где хранятся сгенерированные изображения?

В папке assets/components/phpthumbon/cache/. Можно очищать её для сброса кэша.

Как ускорить генерацию превью?

Используйте кэш pThumb, заранее генерируйте ключевые размеры, подключайте через srcset для адаптивности.