Оглавление

pThumb имеет следующие системные настройки:

Общие

Название Ключ Описание
Override Cache URL phpthumbof.cache_url Абсолютный URL, который будет добавлен при создания изображений. Данная настройка особенно полезна если вы работаете с контекстами или поддоменами.
Check file modification time phpthumbof.check_mod_time Проверяет время изменения файла исходного изображения и, при необходимости, обновляет кэшированную версию. Изменение значения этого параметра приведет к тому, что все кэшированные в данный момент изображения станут устаревшими.
Cache Cleaning Level pthumb.clean_level Указывает, что плагин кэша должен делать при событиях обновления сайта (очистки кэша сайта). Плагин обрабатывает все 3 кэша: phpThumbOf, pThumb и удаленных изображений. Возможные значения0 — Включен по умолчанию. Ничего не делать.
  • 1 — Отдельная чистка кэша, руководствуясь правилами системных настроек MODx phpthumb_cache_maxage, phpthumb_cache_maxfiles,
  • phpthumb_cache_maxsize. Найти их можно в Системные настройки > core > phpThumb. Изменение значения одной из этих настроек на 0, отключит очистку кэша для этого параметра.
  • 2 — Удалить все кэшированные изображения.

Настройки сниппета pThumb

С версии 2.1 добавлены настройки pThumb Cache. Они позволяют формировать более чистые, более семантические и SEO-дружественные URL-адреса миниатюр. Новая система кэширования сохраняет миниатюры в подкаталогах, которые отражают часть пути исходного изображения, и добавляет только 8-символьный хэш к именам файлов. Вы можете создать каталог, в который будут помещаться кэшированные изображения через настройки ниже:

Название Ключ Описание
Images Base Directory​ pthumb.ptcache_images_basedir Каталог с вашими изображениями. По умолчанию это assets/, но если вы хотите изменить расположение ваших изображений, укажите папку в этой настройке. Этот каталог и любые другие над ним будут исключены из пути кеша. Любые подкаталоги под ним будут включены.
pThumb Cache Location pthumb.ptcache_location Каталог для хранения кэшированных изображений. Путь указывается относительно базового каталога MODx, который обычно является корнем вашего сайта. По умолчанию установлен путь assets/image-cache. Создавать каталоги вручную необязательно, pThumb создаст этот каталог сам, если он еще не существует и  если позволяют разрешения файловой системы.
Use pThumb Cache pthumb.use_ptcache После того как вы изменили две вышеуказанные настройки, переключите эту настройку на значение «Да», чтобы применить новые настройки кэша.

Настройки сниппета phpThumbOf

Настройки ниже относются только к сниппету phpthumbof

Название Ключ Описание
Override Cache Path phpthumbof.cache_path Вы можете указать здесь абсолютный путь, для переопределения пути кешированных изображений.

Post-fix Properties Hash to Name
phpthumbof.postfix_property_hash Если включить, будет добавлять хэш к названию файлов.

Настройки изображений

pThumb поставляется в комплекте с Resizer, легкой и современной альтернативой phpThumb. Resizer основан на Imagine и поддерживает расширения Gmagick, Imagick и GD. Для операций по изменению размера и кадрированию изображений он значительно быстрее, чем phpThumb. Плюс все опции ZC теперь работают с GD.

См. Документацию Resizer для более подробной информации о его требованиях и поддерживаемых опциях. Обратите внимание, что он не поддерживает ни один из фильтров phpThumb, но многие из этих вещей в настоящее время могут быть выполнены с помощью CSS.

Название Ключ Описание
Use Resizer phpthumbof.use_resizer
Глобальный параметр, для которого используется класс манипулирования изображениями. Установка значения «Нет» означает, что pThumb будет использовать встроенный в MODx класс phpThumb. По умолчанию: нет.
Global Default Options pthumb.global_defaults Строка с параметрами для ресайза изображений с помощью класса Resizer. Например q=60&za=C.