Misc ddResizeImage

Виджет для плагина ManagerManager, позволяющий изменять размеры изображений (TV), например: делать маленькие превьюшки (thumbs).

Виджет срабатывает только в момент сохранения документов (событие «OnBeforeDocFormSave») и не создаёт изображений повторно, что обеспечивает минимальный расход ресурсов сервера.

mm_ddResizeImage($tvs, $roles, $templates, $width, $height, $cropping, $suffix, $background, $multipleField, $colNum, $splY, $splX, $num);

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

Название Описание Допустимые значения Значение по умолчанию Обязателен?
tvs Имена TV с изображениями, для которых необходимо применить виджет. {comma separated string} true
roles Роли, для которых необходимо применить виждет, пустое значение — все роли. {comma separated string} false
templates Id шаблонов, для которых необходимо применить виджет, пустое значение — все шаблоны. {comma separated string} false
width Ширина создаваемого изображения в px. Пустое значение — автоматический расчёт исходя из высоты. Обязателен хотя бы один размер. {integer} true
height Высота создаваемого изображения в px. Пустое значение — автоматический расчёт исходя из ширины. Обязателен хотя бы один размер. {integer} true
cropping Обрезать ли изображение, пытаясь добиться жесткого соответствия размерам. 0 — не обрезать; 1 — просто обрезать (не изменяя масштаб); 'crop_resized' — сначала уменьшить, затем обрезать; 'fill_resized' — пропорционально уменьшить, заполнив образовавшиеся поля цветом («background»). 0; 1; 'crop_resized'; 'fill_resized' 'crop_resized' false
suffix Суффикс для имен создаваемых изображений. При пустом значении заменяются исходные изображения! {string} '_ddthumb' false
replaceFieldVal Нужно ли переписывать значения в TV на имена созданных изображений (те, что с учётом «suffix»). Не работает при multipleField = 1! 0; 1 0 false
background Цвет фона (используется при cropping = 'fill_resized'). {string} '#FFFFFF' false
multipleField Является ли поле множественным (для mm_ddMultipleFields). 0; 1 0 false
colNum Номер колонки, в которой находится изображение (для mm_ddMultipleFields). {integer} 0 false
splY Разделитель строк (для mm_ddMultipleFields). {string} '||' false
splX Разделитель колонок (для mm_ddMultipleFields). {string} '::' false
num Номер строки, которую надо обрабатывать (для mm_ddMultipleFields). {integer};'all' 'all' false

Примеры

Создать для изображений, выставленных в TV «imageTV», уменьшенные копии шириной 200 px (высота пусть рассчитывается автоматически)

mm_ddResizeImage('imageTV', '', '', 200);

Создать для изображений, выставленных в TV «imageTV», уменьшенные копии размером 200 × 100 px, а что не влезет — пусть обрежется

mm_ddResizeImage('imageTV', '', '', 200, 100);

Создать для изображений, выставленных в TV «imageTV», уменьшенные копии, перезаписывая значения в TV

mm_ddResizeImage('imageTV', '', '', 200, 100, 'crop_resized', '_ddthumb', 1);

Пользователь загрузил и вставил в TV 'assets/images/some.jpg', а после сохранения документа сделалась превьюшка и значение TV стало 'assets/images/some_ddthumb.jpg'. Обеспечить, чтобы пользователи загружали изображения в TV «logo» строго размером 125 × 68 px Всё, что загружается, должно быть пропорционально уменьшено до заданного размера, а если пропорции не верные, то свободное пространство должно быть залито цветом '#686868'.

mm_ddResizeImage('imageTV', '', '', 125, 68, 'fill_resized', '', 0, '#686868');
Mem: 3.5 mb, MySQL: 0.0026 s, 2 req., PHP: 0.0375 s, all: 0.0401 s, cache.