EnglishСниппет для вывода галереи ресурса.
Параметры
| Параметр | По умолчанию | Описание |
|---|---|---|
| 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`
]]