
Фотогалерея из папки с изображениями
LeoGallery превращает короткий шорткод в галерею миниатюр. Загрузите фотографии в папку сайта, укажите её в материале — и посетитель сможет открыть изображения в увеличенном виде через Fancybox.
Размеры миниатюр задаются в шорткоде или настройках плагина. Миниатюры создаются автоматически и сохраняются в кэше: при следующем просмотре готовые файлы используются повторно.
Возможности
- Галерея из файлов JPEG, PNG, GIF и WebP в выбранной папке.
- Увеличение оригинального изображения через Fancybox.
- Автоматическое создание миниатюр с обрезкой по центру до заданного размера.
- Отложенная загрузка миниатюр средствами браузера.
- Естественная сортировка файлов по имени: удобно использовать названия
01.jpg,02.jpgи далее. - Поддержка привычного формата шорткодов Simple Image Gallery.
- Учёт EXIF-ориентации JPEG при наличии расширения PHP EXIF.
- Подключение Fancybox из локальных файлов, с CDN или использование уже подключённой совместимой библиотеки.
Установка и первая галерея
- Скачайте ZIP с этой страницы. Распаковывать архив перед установкой не нужно.
- В Joomla откройте Система → Установка → Расширения и загрузите ZIP.
- В управлении плагинами найдите и включите «Система — LeoGallery».
- Создайте папку, например
images/gallery/portfolio, и загрузите в неё изображения. - Вставьте в материал шорткод из примера ниже и сохраните материал.
- Откройте страницу сайта и проверьте миниатюры и увеличение изображений.
Пример с заданными размерами
{gallery}gallery/portfolio:240:180{/gallery}Плагин найдёт изображения в images/gallery/portfolio и создаст миниатюры шириной 240 и высотой 180 пикселей. Это размеры превью, а при увеличении открывается оригинальный файл.
Пример с размерами из настроек
{gallery}gallery/portfolio{/gallery}Изначальные значения — 150 × 200 пикселей. Их можно изменить в настройках системного плагина.
Как указывать папку
| В шорткоде | Где лежат изображения |
|---|---|
portfolio | images/portfolio |
gallery/portfolio | images/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, проверьте её совместимость, прежде чем отключать подключение библиотеки в плагине.
Настройки и требования
| Параметр | Исходное значение | Назначение |
|---|---|---|
| Корень изображений | 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 системного плагина, предоставленный автором. Архив опубликован без изменений и доступен бесплатно.