Что такое Image+?
Image+ - это расширение Image, входящего в состав MODx работающее с TV. Оно обеспечивает функцию кадрирования изображений при выборе их с помощью интерфейса TV ресурса. Разработчики могут задать ограничение высоты / ширины вместе или по отдельности, а редактор обеспечит обрезку изображения в соответствии с заданными параметрами. URL может быть выдан как в исходном виде, так и отформатированном с помощью использования чанка, позволяющего использовать тэг Alt, title изображения для добавления их к вашим изображениям из области TV.
Системные требования
- MODx Revolution 2.2.x или более поздняя версия
- PHP5 или более поздняя версия
- расширение phpThumbOf
История создания и дополнительная информация.
Image+ написано Аланом Пичем (Alan Pich) в начале 2012 Версия 1.x содержала слишком много ошибок для использования в качестве компонента, поэтому расширение было полностью переписано и в виде версии 2.0 было опубликовано в конце ноября 2012.
Загрузка
Вы можете загрузить ПО с помощью менеджера MODx Revolution, используя Package Management, или из хранилища дополнений MODx.
Использование
Image+ состоит из двух компонентов, вызываемых Image+ : входной и выходной TV . Для корректной работы оба компонента должны быть отмечены как TV. Дополнительные опции для настройки выходных данных быть сконфигурированы в разделе Шаблонных переменных.
Входные опции
Когда Image+ становится выбранным в качестве входного типа для TV, нижеописанные опции становятся доступными:
Поле |
Описание |
Target Width |
Опциональное ограничение ширины выходного изображения. Если установлено, выходное TV изображение будет точно такой ширины. Может быть использовано вместе с полем Target Height для ограничения размеров изображения. |
Target Height |
Опциональное ограничение высоты выходного изображения. Если установлено, выходное TV изображение будет точно такой высоты. Может быть использовано вместе с полем Target Width для ограничения размеров изображения. |
Alt tag field |
Если установлено в положение “Yes”, становится доступным дополнительное поле, используемое при редактировании TV для ресурса. Это поле может быть использовано для добавления title или тэга Alt изображению. Используется вместе с выходным чанком (см. ниже Выходные опции) |
Выходные опции
Данные опции носят исключительно вспомогательный характер, но они генерируют и позволяют использовать множество дополнительных опций для изображений. Доступны следующие опции:
Поле | Описание |
Additional phpThumb params | Позволяет вводить дополнительные параметры для передачи в phpThumb и создания изображения. Формат url должен быть таким: (fltr[]=abc&zc=1...) |
Output Chunk | Если поле оставить незаполненным, TV будет выводить исходный url для подготовленного изображения. Есть возможность задать имя чанка для использования определенного выходного формата. О доступных плейсхолдерах будет написано ниже. |
Чанк для выходных данных
Чанк для выходных данных выбирается опционально, он дает доступ к другим плейсхолдерам, позволяющим лучше настроить выходные TV. Доступны следующие плейсхолдеры:
Плейсхолдеры |
Описание |
Url изображения. Значение по умолчанию, если Output Chunk не задан. |
|
Ширина выходного изображения (если задана во Входных Опциях) |
|
Высота выходного изображения (если задана во Входных Опциях) |
|
Текст для Alt тэга (если задан во Входных Опциях) |