# Описание

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

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

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

[![g3x.gif](https://docs.ivan345.com/uploads/images/gallery/2025-07/2N0jpXB8xokFdMQI-g3x.gif)](https://docs.ivan345.com/uploads/images/gallery/2025-07/2N0jpXB8xokFdMQI-g3x.gif)

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

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

<div align="center" class="MsoNormal" id="bkmrk-" style="text-align: center;">---

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

Интерфейс галереи интегрируется в виде отдельной вкладки "Галерея <span lang="EN-US" style="mso-ansi-language: EN-US;">G</span>3" на странице редактирования ресурса и включает в себя:

- **Современный загрузчик:**
- Загрузка файлов простым перетаскиванием (Drag-n-Drop).
- Поддержка множественной загрузки файлов.

- **Автоматическая генерация превью:**
- При загрузке автоматически создаются миниатюры (small, medium и любые другие) согласно настройкам, указанным в специальном Источнике файлов "Gallery3x Source".

- **Удобное управление:**
- Все изображения ресурса отображаются в виде наглядной сетки превью.
- **Пагинация** для галерей с большим количеством изображений.
- **Сортировка** простым перетаскиванием миниатюр.
- **Множественное выделение** файлов с помощью Ctrl + Click для групповых операций.

- **Контекстное меню (правый клик по миниатюре):**
- **Изменить свойства:** Открывает удобное окно для редактирования полей Название (title), Альтернативный текст (alt) и Описание.
- **Включить/Выключить:** Позволяет временно скрывать изображения из вывода на сайте.
- **Перегенерировать превью:** Обновляет миниатюры для одного или нескольких выделенных файлов.
- **Удалить файл(ы):** Полностью удаляет запись из базы данных и все физические файлы с сервера.


<div align="center" class="MsoNormal" id="bkmrk--1" style="text-align: center;">---

</div>**Возможности на сайте (сниппет \[\[!Gallery3x\]\])**

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

- **Универсальный вывод данных:** Сниппет не привязан к конкретной библиотеке или HTML-верстке. Он готовит массив данных для каждого изображения, включая:
- Все поля из базы данных (name, alt, description и т.д.).
- URL к оригинальному файлу (\[\[+original\_url\]\]).
- URL ко **всем** заранее сгенерированным превью <span lang="EN-US" style="mso-ansi-language: EN-US;">(\[\[+small\_url\]\], \[\[+medium\_url\]\] </span>и<span style="mso-ansi-language: EN-US;"> </span>т<span lang="EN-US" style="mso-ansi-language: EN-US;">.</span>д<span lang="EN-US" style="mso-ansi-language: EN-US;">.).</span>

- **Встроенная логика:**
- Фильтрация по текущему ресурсу.
- Вывод только **активных** файлов.
- Вывод в порядке, заданном **ручной сортировкой**.
- Опция &amp;debug=1`` для быстрой отладки.


<div align="center" class="MsoNormal" id="bkmrk--2" style="text-align: center;">---

</div>**Установка и настройка**

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