PhotoMechanicsGallery

PhotoMechanicsGallery — галерея интерактивных 3D фото, созданных с помощью Photomechanics Photo3D Studio.

PhotoMechanicsGallery интегрирована со следующими галереями:

• miniShop2
• ms2Gallery
• ResVideoGallery

Видео-обзор

При загрузки архива с фото имеется возможность автоматически изменить их размер или наложить водяной знак.

Для это в системных настройках компонента включите опцию “Изменять размер”, а также задайте нужны размеры в опции “Параметры размеров фото”, где в size1 — параметры обычных фото, а size2 — параметры фото для зума. Все манипуляции с фото будут происходить с помощью phpThumb.

После извлечения фото из архива он автоматически удаляется, чтобы этого не происходило включите в системных настройках опцию “Сохранять архив”. Наличие архива позволяет в дальнейшем перегенерировать фото на его основе если текущие по какой то причине для этого не подходят.

Предварительные настройки сервера

Так как загрузка происходит в виде zip архива, который может достигать относительно больших размеров, то необходимо сделать предварительные настройки, как непосредственно в Modx, так и в конфигурации php.

В Modx установите нужное значение в системной настройке компонента “Максимальный размер загружаемых файлов”.

В php.ini установите нужное значение для upload_max_filesize и post_max_size

На слабых серверах изменения размеров фото или наложения водяного знака может занимать достаточно продолжительное время, что может приводить к ошибки выполнения скрипта по причине разрыва соединения браузеров. Поэтому для таких случаев необходимо в системных настройках компонента включить опцию “Использовать очередь задач”, а также добавить вызов каждую минуту кроном скрипта /ваш полный путь /core/components/photomechanicsgallery/cron/queue.php после чего вся работа с архивом и фото будет происходить в фоновом режиме.

Сниппеты

PhotoMechanicsGallery — сниппет для вывода галереи.

Параметры:
tpl — чанк Fenom для оформления всей галереи. По умолчанию: tpl.PhotoMechanicsGallery
parents — список контейнеров, через запятую, для поиска файлов галерей. По умолчанию параметр пуст, то есть выборка не ограничивается родителями и слушается параметра &resources.
resources — список ресурсов, через запятую, для вывода файлов галереи. Если параметр пуст — выводится галерея текущего ресурса.
limit — лимит выборки результатов. По умолчанию: 0.
offset — пропуск результатов с начала выборки. По умолчанию: 0.
sortby — сортировка выборки. По умолчанию: rank.
sortdir — направление сортировки. По умолчанию: ASC.
totalVar — имя плейсхолдера для сохранения общего количества результатов. По умолчанию: total.
tagsVar — усли этот параметр не пуст, то сниппет будет принимать из значение «tags» в $_REQUEST[указанное имя]. Например, если вы укажите здесь «tag», то сниппет будет выводить только файлы, подходящие в $_REQUEST[«tag»].
tags — список тегов, разделённых запятыми, для вывода файлов.
getTags — сделать дополнительные запросы, чтобы получить строку с тегами файла? По умолчанию: нет.
tagsSeparator — если вы включили получение тегов файлов при выводе, то они будут разделены через строку, указанную в этом параметре. По умолчанию: ','.
where — строка, закодированная в JSON, с дополнительными условиями выборки. Для фильтрации по файлам нужно использовать псевдоним таблицы «File». Например &where=`{«File.name:LIKE»:"%img%"}`
mixing — перемешивать результат выборки. По умолчанию: нет.
cacheTime — время кэширования галереи (сек.), сгенерированной для текущих выбранных ресурсов. При нулевом значении кэш не используется. По умолчанию: 0.
autoPlayVideo — автоматически запускать проигрывание видео. По умолчанию: да.
includeGalleries — список галерей через запятую, порядок указания влияет на порядок вывода. Доступны такие значения: PhotoMechanicsGallery; ResVideoGallery; ms2Gallery; MS2Images. По умолчанию: PhotoMechanicsGallery.
js — если вы хотите использовать собственные скрипты — укажите путь к ним здесь, или очистите параметр и загрузите их вручную через шаблон сайта.
css — если вы хотите использовать собственные стили — укажите путь к ним здесь, или очистите параметр и загрузите их вручную через шаблон сайта.
js3DPhotoOptions — опции для js плагина «3D фото» в JSON формате.
jsCarouselOptions — опции для jQuery плагина карусели "OwlCarousel2" в JSON формате.
jsFancyBoxOptions — опции для jQuery плагина "fancybox" в JSON формате.

Системные события

pmgOnAfterUnpack — событие происходит после того, как архив с фотографиями разархивирован в нужную директорию.

Параметры:
object — объект класса PhotoMechanicsGalleryFile

Зависимости

• jQuery 1.9.1+

Скачать