Частный Joomla-разработчик · работаю удалённо
My Joomla — блог веб-разработчика на JoomlaОбсудить задачу
Авторское расширение

LeoGallery

Галереи изображений для Joomla 5 и 6: миниатюры из папки, увеличение в Fancybox, кэширование и привычные шорткоды Simple Image Gallery.

LeoGallery: миниатюры и увеличение изображений в Fancybox

Фотогалерея из папки с изображениями

LeoGallery превращает короткий шорткод в галерею миниатюр. Загрузите фотографии в папку сайта, укажите её в материале — и посетитель сможет открыть изображения в увеличенном виде через Fancybox.

Размеры миниатюр задаются в шорткоде или настройках плагина. Миниатюры создаются автоматически и сохраняются в кэше: при следующем просмотре готовые файлы используются повторно.

Возможности

  • Галерея из файлов JPEG, PNG, GIF и WebP в выбранной папке.
  • Увеличение оригинального изображения через Fancybox.
  • Автоматическое создание миниатюр с обрезкой по центру до заданного размера.
  • Отложенная загрузка миниатюр средствами браузера.
  • Естественная сортировка файлов по имени: удобно использовать названия 01.jpg, 02.jpg и далее.
  • Поддержка привычного формата шорткодов Simple Image Gallery.
  • Учёт EXIF-ориентации JPEG при наличии расширения PHP EXIF.
  • Подключение Fancybox из локальных файлов, с CDN или использование уже подключённой совместимой библиотеки.

Установка и первая галерея

  1. Скачайте ZIP с этой страницы. Распаковывать архив перед установкой не нужно.
  2. В Joomla откройте Система → Установка → Расширения и загрузите ZIP.
  3. В управлении плагинами найдите и включите «Система — LeoGallery».
  4. Создайте папку, например images/gallery/portfolio, и загрузите в неё изображения.
  5. Вставьте в материал шорткод из примера ниже и сохраните материал.
  6. Откройте страницу сайта и проверьте миниатюры и увеличение изображений.

Пример с заданными размерами

{gallery}gallery/portfolio:240:180{/gallery}

Плагин найдёт изображения в images/gallery/portfolio и создаст миниатюры шириной 240 и высотой 180 пикселей. Это размеры превью, а при увеличении открывается оригинальный файл.

Пример с размерами из настроек

{gallery}gallery/portfolio{/gallery}

Изначальные значения — 150 × 200 пикселей. Их можно изменить в настройках системного плагина.

Как указывать папку

Примеры путей к изображениям
В шорткодеГде лежат изображения
portfolioimages/portfolio
gallery/portfolioimages/gallery/portfolio
/images/gallery/portfolioПолный путь от корня сайта к той же папке.
20260811_001Сначала проверяется images/20260811_001, затем — папка с этим именем в настроенной папке галерей редактора, по умолчанию images/gallery.

Плагин работает с папками на вашем сайте. Внешние URL вместо пути к галерее не используются.

Fancybox: локальные файлы или CDN

В настройке «Файлы Fancybox» доступны три варианта:

  • «Загружать с CDN» — исходное значение настройки в этом выпуске. Библиотека загружается с внешнего сервера.
  • «Использовать локальные файлы плагина» — JavaScript и CSS уже входят в ZIP; внешнее подключение Fancybox не требуется.
  • «Не подключать» — для сайта, на котором уже подключена совместимая версия Fancybox с API Fancybox.bind.

Для работы без CDN выберите локальные файлы после установки. Если на сайте уже есть другая версия Fancybox, проверьте её совместимость, прежде чем отключать подключение библиотеки в плагине.

Настройки и требования

Основные параметры LeoGallery 1.3.0
ПараметрИсходное значениеНазначение
Корень изображенийimagesБазовая папка поиска галерей.
Папка галерей редактораimages/galleryВ том числе используется при поиске папки по короткому имени.
Папка кэша миниатюрcache/leogalleryХранение созданных миниатюр.
Тег шорткодаgalleryНазвание открывающего и закрывающего тегов.
Размеры миниатюр150 × 200 pxИспользуются, когда размеры не указаны в шорткоде.
Качество миниатюр85Качество сохраняемых JPEG-миниатюр.

По README плагин совместим с Joomla 5 и Joomla 6. Требования самого плагина — PHP 8.1+ и расширение GD; версия PHP также должна соответствовать требованиям установленной Joomla. Для корректного поворота JPEG рекомендуется расширение EXIF. Папка кэша должна быть доступна серверу для записи.

Переход с Simple Image Gallery

LeoGallery понимает формат {gallery}папка:ширина:высота{/gallery}, включая дополнительные параметры старых шорткодов после размеров. Дополнительные параметры пропускаются: это совместимость синтаксиса, а не обещание всех возможностей другого расширения.

{gallery}0001:150:200{/gallery}

Для этого примера изображения должны находиться в images/0001. После перехода проверьте существующие галереи и отключите другой обработчик того же шорткода, чтобы расширения не мешали друг другу.

Частые вопросы

Почему галерея не появилась?

Проверьте, включён ли системный плагин, правильно ли указан путь и есть ли в папке поддерживаемые изображения. Для генерации миниатюр нужны PHP GD и права записи в папку кэша. Пустая или неверная папка не создаст галерею.

Как очистить миниатюры?

При стандартном пути cache/leogallery откройте Система → Очистить кэш и очистите группу leogallery. При следующем просмотре плагин создаст миниатюры заново.

Нужна ли кнопка редактора для работы?

Нет. Системный плагин может работать с шорткодами, добавленными вручную. Кнопка редактора — отдельное расширение для удобной вставки; в опубликованном здесь системном ZIP её нет.

Текущий выпуск

Версия 1.3.0. На этой странице доступен исходный ZIP системного плагина, предоставленный автором. Архив опубликован без изменений и доступен бесплатно.