Описание

Gallery3x — это современный компонент галереи изображений, разработанный эксклюзивно для MODX3. Он служит мощной и удобной альтернативой популярным решениям, которые не были обновлены для последней версии CMS.

Многие разработчики знают и любят отличный компонент ms2Gallery, который долгие годы был стандартом для создания галерей. Однако, он был создан для MODX2 и не имеет официальной поддержки в MODX3.

Gallery3x призван занять эту нишу, предлагая схожий богатый функционал, но на совершенно новой, современной технологической базе, полностью совместимой с MODX3.

Основные преимущества

• Только для MODX3: Компонент использует все новые возможности и архитектуру третьей версии MODX.
• Высокая производительность: Вся обработка изображений и создание превью происходят один раз в админ-панели при загрузке файла. На сайте выводятся уже готовые картинки, что гарантирует максимальную скорость загрузки страниц.
• Современные технологии: Для обработки изображений используется передовая серверная библиотека Glide, обеспечивающая высокое качество и скорость генерации превью.

Возможности в админ-панели (на странице ресурса)

Интерфейс галереи интегрируется в виде отдельной вкладки "Галерея G3" на странице редактирования ресурса и включает в себя:

• Современный загрузчик:
• Загрузка файлов простым перетаскиванием (Drag-n-Drop).
• Поддержка множественной загрузки файлов.
• Автоматическая генерация превью:
• При загрузке автоматически создаются миниатюры (small, medium и любые другие) согласно настройкам, указанным в специальном Источнике файлов "Gallery3x Source".
• Удобное управление:
• Все изображения ресурса отображаются в виде наглядной сетки превью.
• Пагинация для галерей с большим количеством изображений.
• Сортировка простым перетаскиванием миниатюр.
• Множественное выделение файлов с помощью Ctrl + Click для групповых операций.
• Контекстное меню (правый клик по миниатюре):
• Изменить свойства: Открывает удобное окно для редактирования полей Название (title), Альтернативный текст (alt) и Описание.
• Включить/Выключить: Позволяет временно скрывать изображения из вывода на сайте.
• Перегенерировать превью: Обновляет миниатюры для одного или нескольких выделенных файлов.
• Удалить файл(ы): Полностью удаляет запись из базы данных и все физические файлы с сервера.

Возможности на сайте (сниппет [[!Gallery3x]])

Компонент предоставляет один мощный и универсальный сниппет Gallery3x для вывода уже подготовленных изображений на сайте.

• Универсальный вывод данных: Сниппет не привязан к конкретной библиотеке или HTML-верстке. Он готовит массив данных для каждого изображения, включая:
• Все поля из базы данных (name, alt, description и т.д.).
• URL к оригинальному файлу ([[+original_url]]).
• URL ко всем заранее сгенерированным превью ([[+small_url]], [[+medium_url]] и т.д.).
• Встроенная логика:
• Фильтрация по текущему ресурсу.
• Вывод только активных файлов.
• Вывод в порядке, заданном ручной сортировкой.
• Опция &debug=1`` для быстрой отладки.

Установка и настройка

• Автоматическая инсталляция: При установке компонент автоматически создает таблицу в базе, Источник файлов "Gallery3x Source" и необходимые системные настройки.
• Динамическая привязка: Резолвер автоматически прописывает ID созданного Источника файлов в системную настройку gallery3x.source_id.
• Глобальная обработка изображений: Все параметры обработки настраиваются централизованно в системных настройках, что позволяет применять их ко всем загружаемым изображениям.
• Настройка превью: Размеры миниатюр (w, h, fit и т.д.) задаются в свойствах Источника файлов в простом JSON-формате.
• Формат по умолчанию: Возможность автоматически конвертировать все превью в современные форматы, такие как WebP или AVIF.
• Фильтры и эффекты: Применение различных фильтров (например, greyscale, blur, pixelate) ко всем превью через строку параметров.
• Водяной знак: Автоматическое наложение водяного знака на все генерируемые изображения с гибкой настройкой его положения и отступов.