Skip to main content

Gallery3x

Компонент Gallery3x поставляется с основным сниппетом [[!Gallery3x]], который отвечает за вывод изображений на страницах сайта. Сниппет разработан с упором на гибкость и производительность, позволяя создавать галереи любой сложности.

Ключевая особенность

Сниппет не создает превью "на лету". Он работает с уже готовыми, заранее сгенерированными изображениями, которые были созданы в админ-панели при загрузке файлов. Это обеспечивает максимальную скорость загрузки страниц для посетителей вашего сайта.

Сниппет [[!Gallery3x]]

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

Документация с добавленным новым параметром.

раметр По умолчанию Описание
&resource ID текущего ресурса ID ресурса, из которого нужно вывести изображения. Используется, если &parents и &resources не заданы.
&parents null Список ID родительских ресурсов через запятую. Выбирает картинки из этих ресурсов и всех их дочерних. 0 — выборка со всего сайта.
&resources null Список ID ресурсов через запятую. ID с минусом (-) исключает ресурс. Имеет приоритет над &parents, если указаны положительные ID.
&tplOuter ... Имя чанка-обертки для сложных галерей (например, каруселей).
&tplThumb ... Имя чанка для элемента в ленте превью (используется вместе с tplOuter, игнорируется в режиме Fenom).
&fenom 0 Если установить в 1 и на сайте установлен pdoTools, сниппет будет работать в режиме Fenom. В этом режиме он не обрабатывает чанк &tplThumb, а передает в чанк &tplOuter сырой массив со всеми данными {$files}, который вы можете обработать в цикле {foreach}.
&limit 0 Ограничение на количество выводимых изображений. 0 — без ограничений.
&sortby position Поле для сортировки изображений.
&sortdir ASC Направление сортировки (ASC или DESC).
&showInactive 0 Если установить в 1, будут выводиться также и выключенные в админке изображения.
&where '' JSON-строка с дополнительными условиями выборки.
&debug 0 Если установить в 1, вместо галереи на странице будет выведен массив со всеми данными, которые сниппет подготовил.
&group
Фильтр по группе
&return
Определяет формат возвращаемых данных. (data, json, ids)
&toPlaceholder
Сохраняет данные в **плейсхолдер** вместо вывода. Сниппет возвращает пустую строку.

Доступные плейсхолдеры

Сниппет передает в чанк все поля из таблицы компонента, а также автоматически генерирует URL для всех существующих превью.

  • [[+id]] - ID записи

  • [[+name]] - Название (title)

  • [[+description]] - Описание

  • [[+alt]] - Альтернативный текст

  • [[+file]] - Имя файла (например, my-photo.jpg)

  • [[+createdon]] - Дата загрузки

  • [[+size]] - Размер файла в байтах

  • [[+original_url]] - URL к оригинальному изображению

  • [[+small_url]] - URL к превью 'small'

  • [[+medium_url]] - URL к превью 'medium'

  • [[+любое_имя_превью_url]] - Если вы создадите превью с именем big, здесь будет доступен плейсхолдер [[+big_url]].

сниппет Gallery3x поддерживает параметры `&return` и `&toPlaceholder`, которые позволяют получать данные галереи в виде массива или JSON вместо готового HTML. Это особенно полезно при работе с Fenom-циклами, PdoPage с ajax-загрузкой, и для создания кастомной разметки.

Back to top