4.1 KiB
Галереи
Модуль galleries собирает изображения общей медиатеки в управляемые коллекции.
Файлы не копируются: галерея хранит URL, подписи, порядок и настройки вывода.
Поддерживаются сетка и слайдер, WebP и разрешённые пресеты миниатюр.
Вставка и публичная страница
[mod_gallery:3]
Число — ID опубликованной галереи. Для самостоятельной страницы используется
URL /galleries/<alias>; базовая часть меняется в настройках. На странице
работает пагинация gpage, а вставочный тег выводит коллекцию целиком.
Теги шаблона галереи
| Тег | Значение |
|---|---|
[tag:id] |
ID галереи. |
[tag:title] |
Экранированное название. |
[tag:description] |
Готовое описание либо пустая строка. |
[tag:mode] |
Режим grid или slider. |
[tag:columns] |
Настроенное число колонок. |
[tag:items] |
Собранные изображения в заданном порядке. |
[tag:count] |
Число элементов текущего вывода. |
[tag:pagination] |
Навигация публичной страницы. |
Теги изображения
| Тег | Значение |
|---|---|
[tag:id] |
ID элемента галереи. |
[tag:index] |
Индекс в текущей выдаче, начиная с 0. |
[tag:source] |
URL исходного файла для лайтбокса. |
[tag:thumb] |
URL миниатюры выбранного пресета. |
[tag:webp] |
URL связанного WebP-исходника либо пустая строка. |
[tag:picture] |
Готовый <picture>/<img> с lazy loading. |
[tag:title] |
Экранированный заголовок. |
[tag:alt] |
Alt-текст; при пустом значении используется title. |
[tag:description] |
Готовая подпись либо пустая строка. |
[tag:link] |
Дополнительная проектная ссылка элемента. |
Штатный лайтбокс использует data-gallery, data-gallery-items,
data-gallery-item, data-gallery-open и data-gallery-index. Для полностью
собственного JavaScript эти атрибуты можно заменить вместе с assets темы.
Миниатюра строится только через разрешённый preset. Если генератор не может
создать её, renderer безопасно использует URL исходника. Для WebP создаётся
отдельный <source> только когда связанный файл существует.
Новая галерея по умолчанию получает первый пресет из системного белого списка;
после изменения списка недоступные старые значения нормализуются миграцией
модуля.
API и hook
GET /api/v1/galleries/3
JSON содержит настройки коллекции и элементы: file_url, webp_url, title,
alt, description, link и status. HTML в API не навязывается, поэтому endpoint
подходит для своего слайдера или мобильного клиента.
Фильтр galleries.rendering получает массив gallery и готовый html.
Удаление галереи очищает её записи, но не удаляет исходники и миниатюры общей
медиатеки.