ms2Gallery

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

Параметры

Параметр	По умолчанию	Описание
parents		Список категорий, через запятую, для поиска результатов. По умолчанию выборка ограничена текущим родителем. Если поставить 0 - выборка не ограничивается.
resources		Список ресурсов, через запятую, для вывода в результатах. Если id товара начинается с минуса, этот товар исключается из выборки.
showLog		Показывать дополнительную информацию о работе сниппета. Только для авторизованных пользователей в контексте mgr.
toPlaceholder		Если не пусто, сниппет сохранит все данные в плейсхолдер с этим именем, вместо вывода на экран.
tpl	tpl.ms2Gallery	Чанк оформления всей галереи с использованием Fenom.
limit		Лимит выборки результатов
offset		Пропуск результатов с начала выборки
where		Строка, закодированная в JSON, с дополнительными условиями выборки. Для фильтрации по файлам нужно использовать псевдоним таблицы File. Например: &where=`{"File.name:LIKE":"%img%"}`
filetype		Тип файлов для выборки. Можно использовать image для указания картинок и расширения для остальных файлов. Например: image, pdf, xls, doc.
showInactive		Показывать неактивные файлы.
sortby	rank	Сортировка выборки.
sortdir	ASC	Направление сортировки
frontend_css	[[+cssUrl]]web/default.css	Если вы хотите использовать собственные стили - укажите путь к ним здесь, или очистите параметр и загрузите их вручную через шаблон сайта.
frontend_js	[[+jsUrl]]web/default.js	Если вы хотите использовать собственные скрипты - укажите путь к ним здесь, или очистите параметр и загрузите их вручную через шаблон сайта.
tags		Список тегов, разделённых запятыми, для вывода файлов.
tagsVar		Если этот параметр не пуст, то сниппет будет принимать из значение tags в $_REQUEST["указанноеимя"]. Например, если вы укажите здесь tag, то сниппет будет выводить только файлы, подходящие в $_REQUEST["tag"].
getTags		Сделать дополнительные запросы, чтобы получить строку с тегами файла?
tagsSeparator	,	Если вы включили получение тегов файлов при выводе, они будут разделены через строку, указанную в этом параметре.

Чанки

До версии 2.0 в ms2Gallery использовалось 4 чанка:

• tplRow - Чанк оформления одного элемента выборки tpl.ms2Gallery.row.
• tplOuter - Обёртка для вывода результатов работы сниппета tpl.ms2Gallery.outer.
• tplEmpty - Чанк, который выводится при отсутствии результатов tpl.ms2Gallery.empty.
• tplSingle - Чанк, который используется если получен всего один файл.

Теперь же - всего один tpl, который получает массив $files и должен самостоятельно его разобрать:

{if count($files) > 1}
  <!-- файлов много - разбираем их в цикле-->
  {foreach $files as $file}
    <a href="{$file.url}">
      <img src="{$file.small}" />
    </a>
  {/foreach}
{elseif count($files) == 1}
  <!--всего одна картинка, печатаем весь массив данных-->
  {$file | print}
{else}
  Файлов нет, выводим эту надпись.
{/if}

Все превью, сгенерированные для файлов, подключаются автоматически под своими псевдонимами.

Если вы не хотите переходить на новый формат оформления, то просто укажите свои старые чанки и пустой &tpl:

[[!ms2Gallery?
  &tplRow=`tpl.ms2Gallery.row`
  &tplOuter=`tpl.ms2Gallery.outer`
  &tplEmpty=`tpl.ms2Gallery.empty`
  &tplSingle=`tpl.ms2Gallery.single`
  &tpl=``
]]

Но лучше, конечно, переписать их на Fenom. Это будет и работать удобнее, и менять быстрее.

Скрипты и стили

Подключаемые скрипты и стили указываются параметрами frontend_css и frontend_js. По умолчанию там простенькое оформление и смена основной картинки при клике (для старых чанков, до версии 2.0).

Для нового чанка версии 2.0 подключается еще и Fotorama, если у контейнера с картинками присутствует class="fotorama". Вы можете настраивать её согласно документации через data- атрибуты.

Если скрипты и стили вам не нужны, просто укажите эти параметры пустыми:

[[!ms2Gallery?
  &frontend_css=``
  &frontend_js=``
]]

Примеры

Вывод галереи из файлов текущего ресурса

[[!ms2Gallery]]

Вывод картинок из нескольких ресурсов в одну галерею

[[!ms2Gallery?
  &parents=`0`
  &resources=`5,16,7`
]]