Gallery3x

Компонент галереи изображений, видео и файлов, разработанный для MODX3
Автор дополнения
Douglas Quaid
Пакетов
8
Закачек
281
Обычно отвечает в течение 4 часов
Автор дополнения
Пакетов
8
Закачек
281
Обычно отвечает в течение 4 часов
Версия 3.1.0-pl
Дата выпуска 26.03.2026
Загрузки 43
Просмотры 1 522
Внимание, этот компонент требует PHP 8.1 или выше!
Внимание, этот компонент требует MODX 3 или выше.


Gallery3x — Современная галерея для MODX3

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

О компоненте

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

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

Нативная поддержка MODX 3
  • Использует PSR-4 автозагрузку и новую архитектуру процессоров
  • Полная совместимость с namespaces и современными стандартами PHP
  • Интеграция с новой системой Media Sources
Высокая производительность
  • Обработка изображений происходит один раз при загрузке в админке
  • На фронтенде выводятся готовые оптимизированные превью
  • Поддержка современных форматов (WebP, AVIF)
  • Возможность возврата данных без генерации HTML для максимальной скорости

Современные технологии
  • Библиотека Glide 3.1 для обработки изображений высокого качества
  • ExtJS интерфейс с drag-n-drop и пакетными операциями
  • Интеграция с внешними API (VK, Rutube)
  • Полная поддержка Fenom-шаблонизатора

Управление изображениями

В админ-панели

Вкладка «Галерея G3x» на странице редактирования ресурса включает:

Загрузка файлов

Drag-n-Drop загрузка с поддержкой множественных файлов
Автоматическая генерация миниатюр (thumb, small, medium, large и др.)
Настройка размеров и форматов через Media Source «Gallery3x Source»

Управление галереей

Наглядная сетка превью с пагинацией

  • Сортировка простым перетаскиванием
  • Множественное выделение (Ctrl + Click)
  • Группировка изображений для организации по категориям

Контекстное меню (ПКМ)

  • Изменить свойства: название, alt, описание, группа
  • Включить/Выключить: временное скрытие из вывода
  • Перегенерировать превью: обновление миниатюр
  • Удалить: удаление записи и физических файлов

Работа с видео

Поддержка видеоплатформ

Gallery3x поддерживает встраивание видео с автоматическим получением метаданных:

— VK Видео (с OAuth авторизацией) Почему-то не всем VK выдает разрешение использовать API, предупреждаю сразу.
— Rutube
— kinescope (Нужно указать API ключ в настройках компонента)

В ручную:
— YouTube
— Vimeo
— Dailymotion
— Coub

VK интеграция

  • Отдельная вкладка «VK Авторизация» для безопасного OAuth 2.0 с PKCE
  • Автоматическое получение названия, описания и обложки видео
  • Автоматическая загрузка превью на сервер
  • Автоматическое обновление токенов

Работа с файлами
«Файлы G3x» (нужно активировать в настройках компонента).

позволяет прикреплять к любому ресурсу произвольные файлы: документы, архивы, таблицы, презентации, аудио — всё, что не является изображением или видео.

Универсальная кнопка «Получить данные»

При создании видеозаписи одна кнопка автоматически определяет источник:
  • Для VK видео → использует VK API (если авторизован)
  • Для других сервисов → использует oEmbed/API соответствующего сервиса

Гибкость и универсальность

Не привязан к конкретной библиотеке

Используйте любую JS-библиотеку для отображения:
  • Fancybox, Lightbox, PhotoSwipe
  • Swiper, Slick Slider
  • Masonry, Isotope
  • Собственные решения
Поддержка Fenom

{* Встроенная поддержка Fenom для шаблонов *}
[[!Gallery3x?
    &fenom=`1`
    &tplOuter=`@FILE chunks/gallery-outer.tpl`
]]


Гибкая фильтрация

&resources=`123,456,-789`  - конкретные ресурсы (- исключить)
&parents=`10,20`           - все дочерние ресурсы
&group=`Интерьер,Фасад`    - по группам
&showInactive=`0`          - только активные
&where=`{"special":1}`     - произвольные условия


Для кого этот компонент?

Идеально подходит для:
  • Корпоративных сайтов с галереями проектов
  • Сайтов отелей, студий, портфолио
  • Интернет-магазинов (дополнение к будущему miniShop3)
  • Новостных порталов с медиаконтентом
  • Любых проектов, требующих гибкой работы с изображениями и видео

Для разработчиков, которые ценят:
  • Современную архитектуру и чистый код
  • Гибкость и контроль над выводом
  • Производительность и оптимизацию
  • Подробную документацию

Gallery3x — это не просто галерея, это полноценная система управления медиаконтентом для MODX3!

Примеры как могут выглядеть галереи https://demog3x.ivan345.com/
Документация: Документация

3.1.0-pl

-- Исправлен баг с политиками доступа -- Обновлена библиотека Glide 3.2.0

3.0.31-pl

  • Добавлена вкладка «Файлы G3x» для управления файловыми вложениями ресурса
  • Добавлен сниппет Gallery3xFiles с поддержкой Fenom и стандартного синтаксиса MODX
  • Добавлены чанки для вывода файлов: tpl.Gallery3x.Files.outer, tpl.Gallery3x.Files.item, tpl.Gallery3x.Files.outer.fenom
  • Добавлена поддержка Kinescope.io во вкладке «Видео G3x»
  • Полное получение метаданных (название, описание, превью) через REST API (Kinescope.io) при наличии токена (настройка gallery3x.kinescope_api_token)

3.0.30-pl

-- Исправлен парсинг ссылок из rutube -- Обновлена документация по сниппету Gallery3xVideos

3.0.29-pl

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

3.0.28-pl

НОВОЕ - кастомизация процессора получения групп

  • [НОВОЕ] Системная настройка gallery3x.groups_processor - позволяет указать свой процессор для получения списка групп
  • [УЛУЧШЕНИЕ] Расширяемость компонента - можно создать кастомный процессор с собственной логикой (например, фильтрация по resource_id)
  • [ДОКУМЕНТАЦИЯ] Процессор должен возвращать формат: ["results" => [["name" => "group1"], ...], "total" => N]

НОВОЕ - опциональное сохранение оригинального имени файла

  • [НОВОЕ] Системная настройка gallery3x.save_original_name (по умолчанию true) - сохранять или нет оригинальное имя файла в поле "name"
  • [УЛУЧШЕНИЕ] Если выключено - поле "name" остается пустым при загрузке, можно заполнить вручную

3.0.27-pl

НОВОЕ - настройки загрузки для shared хостинга

  • [НОВОЕ] Системная настройка gallery3x.upload_parallel (по умолчанию 1) - количество одновременно загружаемых файлов
  • [НОВОЕ] Системная настройка gallery3x.upload_multiple (по умолчанию false) - группировать файлы в один запрос или нет
  • [УЛУЧШЕНИЕ] Теперь можно настроить загрузку под ограничения shared хостинга (max_file_uploads)

3.0.26-pl

НОВОЕ - автоматическая очистка файлов при удалении ресурсов

  • [НОВОЕ] Плагин Gallery3xCleanup автоматически удаляет файлы изображений и видео с диска при очистке корзины
  • [ИСПРАВЛЕНО] Теперь свойства "Источника файлов" не перезаписывается после обновления компонента.

3.0.25-pl

-- Исправлены ошибки

3.0.24-pl

УЛУЧШЕНИЕ - гибкость выбора размера миниатюр в сниппетах

  • [НОВОЕ] Сниппет Gallery3xMixed теперь поддерживает параметр &thumbSize для выбора размера миниатюры
  • [НОВОЕ] Сниппет g3xCollectionsThumbnail теперь использует системную настройку gallery3x.collections_thumb_size
  • [УБРАНО] Жесткая привязка к размеру 'small' в обоих сниппетах
  • [УЛУЧШЕНИЕ] Умный fallback - если указанный размер не найден, используется первая доступная миниатюра

3.0.23-pl

  • [ИСПРАВЛЕНО] - умный fallback для превью в окне редактирования
  • [УЛУЧШЕНИЕ] Окно редактирования изображения использует автоматический fallback с приоритетом: medium > small > thumb > original
  • [ИСПРАВЛЕНО] Номера позиций в гриде не обновлялись визуально после drag-and-drop сортировки

3.0.22-pl

Интеграция с VK API

  • [НОВОЕ] Добавлена отдельная вкладка "VK Авторизация" (показывается только если указан vk_app_id)
  • [НОВОЕ] Кнопка "Получить данные" автоматически использует VK API для VK видео (если авторизован)
  • [НОВОЕ] Системные настройки: gallery3x.vk_app_id, gallery3x.vk_refresh_token, gallery3x.vk_device_id
  • [НОВОЕ] OAuth 2.0 с PKCE для безопасной авторизации VK

    НОВАЯ ФУНКЦИОНАЛЬНОСТЬ - параметры &return и &toPlaceholder

  • [ДОБАВЛЕНО] Параметр &return для возврата данных вместо HTML:
    • &return=`data` - возвращает массив объектов с полными данными изображений
    • &return=`json` - возвращает JSON (UTF-8, без экранирования)
    • &return=`ids` - возвращает массив ID изображений
  • [ДОБАВЛЕНО] Параметр &toPlaceholder для сохранения данных в плейсхолдер
  • [РЕШЕНА ПРОБЛЕМА] Конфликт с PdoPage при ajax-загрузке в Fenom-циклах (foreach)
  • [УЛУЧШЕНИЕ] Теперь можно обрабатывать данные галереи в Fenom без генерации HTML
  • [ПРОИЗВОДИТЕЛЬНОСТЬ] При &return=`data` пропускается генерация HTML (быстрее для больших галерей)

3.0.21-pl

Новый функционал

  • [Новое] Добавлена опциональная настройка "gallery3x.groups_per_user" - показывать только контент текущего администратора
  • [Новое] Когда настройка включена, каждый админ видит только свои изображения, видео и группы
  • [Новое] Фильтрация работает для: списка файлов, списка видео, списка групп
  • [Новое] По умолчанию выключено - весь контент виден всем администраторам

3.0.20-pl

Новое

  • [Новое] Добавлены ГОТОВЫЕ ПРИМЕРЫ:
    • example.Gallery3x.pdoResources.Simple - простая галерея
    • example.Gallery3x.pdoResources.Fenom - с Fenom
    • example.Gallery3x.pdoResources.Advanced - продвинутая с thumbnail
  • [Новое] Добавлены шаблоны для pdoResources:
    • tpl.Gallery3x.pdoResources.Simple (без Fenom)
    • tpl.Gallery3x.pdoResources.Fenom (с Fenom)
    • tpl.Gallery3x.pdoResources.Advanced (с thumbnail и группами)
  • [Новое] Добавлен сниппет Gallery3xMixed - объединяет изображения и видео с уникальными ID (img_5, video_3)
  • [Новое] Поддержка группировки изображений и видео по любому полю (group, resource_id и т.д.)
  • [Новое] Добавлен общий процессор GetGroupsCombined - группы теперь общие для изображений и видео

Критические исправления

  • [Исправление] Поле "группы" теперь корректно загружается при редактировании изображений и видео
  • [Улучшение] Изображения и видео теперь могут использовать одинаковые названия групп
  • [Исправление] Исправлена установка текущих значений групп в окнах редактирования
  • [Исправление] Исправлен баг с сохранением поля "Особенное" для изображений через форму редактирования

3.0.19-pl

  • Добавлена поддержка видеогалерей в отдельной вкладке
  • Сниппет: Gallery3xVideos - Вывод видео на фронтенде
  • Поддержка фильтрации по группам (множественной)
  • Все параметры как у Gallery3x (resource, parents, limit, sortby и т.д.)
  • Системная настройка: gallery3x.video_enable (Да/Нет) - Включить/выключить видеогалерею
  • Может парсить данные о видеороликах пока только с rutube.ru, видео с других видеохостингов добавляются вручную

3.0.18-pl

  • Доработан сниппет Gallery3x

3.0.17-pl

Новые функции

  • [Новое] Добавлена функциональность "Группы (теги)" для фотографий с возможностью присвоения нескольких групп одной фотографии.
  • [Новое] Добавлена фильтрация по группам в панели галереи с выпадающим списком доступных групп.
  • [Новое] Реализован SuperBoxSelect для удобного выбора и создания групп с визуальными "таблетками".
  • [Новое] Группы теперь глобальные и доступны во всех галереях компонента (не привязаны к конкретному ресурсу).
  • [Новое] Добавлена возможность массового присвоения групп выбранным фотографиям через контекстное меню.

Улучшения

  • [Улучшение] Добавлено отображение порядкового номера (position) рядом с именем фотографии в панели галереи.
  • [Улучшение] Добавлен выбор количества элементов на странице (20/50/100/200) в нижней панели пагинации.
  • [Улучшение] Добавлено отображение групп под превью фотографий через запятую.

3.0.16-pl

Новые функции

  • [Новое] Добавлено поле "Особенное" (special) для файлов. Включает иконку-звездочку в панели, переключатель в контекстном меню и чекбокс в окне редактирования.
  • [Новое] Добавлен процессор File/ToggleSpecial для управления полем "Особенное".
  • [Новое] Добавлена системная настройка gallery3x.new_file_position (со значениями end/start) для выбора, в начало или в конец галереи добавлять новые файлы.

Улучшения

  • [Улучшение] Панель галереи в менеджере теперь использует системную настройку gallery3x.per_page для пагинации (вместо жестко заданного значения 20).
  • [Улучшение] Полностью переписана логика санитаризации (очистки) имен файлов в процессоре File/Upload для лучшей обработки спецсимволов.

Исправления багов

  • [Исправление] Исправлен баг, из-за которого не создавались превью для файлов, начинающихся с _ (нижнего подчеркивания).
  • [Исправление] Исправлен баг, из-за которого не создавались превью для файлов, содержащих сложные символы (например, , пробелы, копия и т.д.).

3.0.15-pl

  • Исправлены ошибки
  • Добавлена новая опция в настройках компонента "gallery3x.new_file_position - Позиция нового файла"

3.0.14-pl

  • Исправлены ошибки

3.0.13-pl

  • Добавлена интеграция с компонентом Collection, подробности в документации

3.0.12-pl

  • Добавлен консольный скрипт для импорта изображений из ms2Gallery в Gallery3x

3.0.10-pl

  • Введена возможность использовать разные источники файлов для разных шаблонов

3.0.6-pl

  • Добавлены чанки примеры на Fenom

3.0.5-pl

  • Добавлены примеры чанков для Fancybox

3.0.4-pl

  • Добавлен консольный скрипт, который перегенерирует все файлы из командной строки

3.0.3-pl

  • Исправлены ошибки
  • Добавлены новые параметры в настройках компонента
  • Обновлены лексиконы

3.0.0-pl

  • The first release

Последние обсуждения в сообществе MODX.pro