Gallery3x — компонент галереи для MODX 3. Он хранит у каждого ресурса изображения, видео, файлы-вложения и встраиваемые объекты (карты, виджеты) и выводит их на сайте сниппетами в любой разметке.
Компонент создан как замена ms2Gallery, у которой нет версии для MODX 3: похожие возможности, но на архитектуре MODX 3 и с готовым скриптом переноса галерей из ms2Gallery.
Главное
- Превью готовятся заранее. Все размеры нарезаются один раз при загрузке (библиотека Glide), на сайт отдаются готовые файлы — страницы не тормозят из-за обработки картинок.
- Любая разметка. Сниппеты отдают в чанки все поля и адреса всех превью; в комплекте готовые чанки для Fancybox, lightGallery и примеры на Fenom.
- Четыре вида содержимого: изображения, видео (YouTube, Rutube, VK, Vimeo, Dailymotion, Coub, OK.ru, Дзен, Kinescope), файлы-вложения и embed-блоки.
- Группы (теги) для фото, видео, файлов и embed — фильтр в админке и параметр
&groupв сниппетах. - Разные источники файлов для разных шаблонов — свои размеры превью и водяной знак для каталога, блога и т.д.
В админке
На странице ресурса (для шаблонов из gallery3x.templates) появляются вкладки:
- Галерея G3x — изображения: загрузка перетаскиванием (в том числе несколькими файлами сразу), сетка превью с постраничным выводом, сортировка перетаскиванием, выделение нескольких фото, фильтр по группе.
- Видео G3x — ссылки на видео; название, описание и обложка подтягиваются автоматически (включается настройкой
gallery3x.video_enable). - Файлы G3x — вложения: PDF, DOC, ZIP и др. (
gallery3x.files_enable). - Embed G3x — карты, виджеты, iframe по ссылке или готовым кодом (
gallery3x.embed_enable).
Через меню правой кнопкой у фото: изменить свойства (название, alt, описание, группы, дополнительные поля), включить/выключить, отметить «особенным», перегенерировать превью, удалить (запись и все файлы на диске). Для выделенных фото — массовая установка групп.
В визуальном редакторе (CKEditor, TinyMCE RTE) есть кнопка «Вставить из галереи» — см. Вставка галерей в визуальный редактор.
На сайте
[[!Gallery3x]]— изображения;[[!Gallery3xVideos]]— видео;[[!Gallery3xFiles]]— файлы;[[!Gallery3xEmbeds]]— embed;[[!Gallery3xMixed]]— фото и видео вместе.- Выборка по текущему ресурсу, списку ресурсов или дочерним ресурсам, по группе, по конкретным ID, с сортировкой, лимитом и условиями
&where. - Режим Fenom (pdoTools), выдача данных массивом/JSON (
&return,&toPlaceholder), отладка&debug. - Плейсхолдеры
[[+g3x.0]],[[+g3x.0.medium]]без вызова сниппета;g3xGetImage— адрес превью по ID (для pdoResources и Collections).
Установка и обслуживание
- При установке создаются таблицы, системные настройки, источник файлов «Gallery3x Source» (его ID записывается в
gallery3x.source_id) и ставится pdoTools, если его нет. - Размеры превью — JSON в свойствах источника файлов; формат (по умолчанию WebP), фильтры и водяной знак — в системных настройках.
- Консольные скрипты: перегенерация всех превью, импорт из ms2Gallery, очистка галерей по шаблону.
- При очистке корзины MODX файлы удалённых ресурсов удаляются с диска.
Требования: MODX 3, PHP 8.2+, расширение Imagick (рекомендуется) или GD.