new

Gallery3x

Компонент галереи изображений и видео, разработанный для MODX3
Автор дополнения
Douglas Quaid
Пакетов
8
Закачек
155
Обычно отвечает в течение 2 часов
Автор дополнения
Пакетов
8
Закачек
155
Обычно отвечает в течение 2 часов
Версия 3.0.23-pl
Дата выпуска 06.11.2025
Загрузки 13
Просмотры 690
Внимание, этот компонент требует версию PHP 8.1 или выше! Если ваш сайт использует PHP ниже требуемого, установка этого дополнения может его сломать.
Внимание, этот компонент требует версию MODX не ниже 3.0 !


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 авторизацией)
— Rutube

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

VK интеграция

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

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

При создании видеозаписи одна кнопка автоматически определяет источник:
  • Для 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.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