Расширение для phpBB Gallery, позволяющее добавлять в альбомы внешние изображения без хранения исходных файлов на сервере phpBB.

Фотографии отображаются внутри phpBB Gallery практически так же, как обычные изображения галереи, но оригинальный файл может физически находиться на другом сайте.

Поддерживаются обычные прямые ссылки на изображения, а также импорт фотографий и целых альбомов из XenForo Media Gallery (XFMG).

## Возможности

- Добавление внешнего изображения по прямой ссылке.
- Пакетное добавление до 100 ссылок.
- Импорт фотографии из XenForo Media Gallery.
- Импорт целого альбома XenForo Media Gallery.
- Автоматическое получение названия и описания фотографии из XenForo.
- Отображение внешних и обычных фотографий в одном альбоме.
- Общая навигация между обычными и внешними фотографиями.
- Отображение внешних фотографий в «Новых» и «Случайных».
- Комментарии.
- Редактирование.
- Перемещение между альбомами.
- Удаление записи без удаления исходного файла.
- Ссылка на оригинальный источник.
- Защита от дублей при импорте XenForo-альбомов.

## История версий

### 0.3.0 — 2026-08-14

- Добавлена поддержка XenForo Media Gallery (XFMG).
- Добавлен импорт отдельной фотографии по ссылке на страницу XenForo Media Gallery.
- Добавлен импорт целого XenForo-альбома по одной ссылке на альбом.
- Название, описание, миниатюра и ссылка на полноразмерное изображение автоматически извлекаются из JSON-LD XenForo.
- Большие XenForo-альбомы импортируются автоматически небольшими порциями, чтобы избежать превышения времени выполнения PHP.
- Добавлена страница прогресса импорта.
- После каждой порции импорт автоматически продолжается до завершения всего альбома.
- Добавлена защита от повторного добавления уже импортированных фотографий.
- При повторном запуске или продолжении импорта существующие фотографии пропускаются.
- Исходные файлы остаются на сервере XenForo; phpBB Gallery хранит только внешние ссылки.

### 0.2.1 — 2026-08-14

- Внешние изображения добавлены в раздел «Новые фото».
- Внешние изображения добавлены в раздел «Случайные фото».
- Обычные и внешние изображения отображаются вместе в единой адаптивной сетке.
- Добавлены JSON-ленты для новых и случайных внешних изображений.
- Сохранена интеграция внешних фотографий с альбомами, навигацией, редактированием, перемещением, удалением и комментариями.

### 0.2.0 — 2026-08-13

- Добавлены комментарии к внешним изображениям.
- Добавлено закрытие и открытие комментариев.
- Добавлено удаление отдельных комментариев.
- Добавлена CSRF-защита форм расширения.
- Внешние фотографии учитываются в количестве фотографий на карточках альбомов.
- Добавлено редактирование внешних изображений.
- Добавлено перемещение изображений между альбомами.
- Добавлено удаление внешних изображений.
- Добавлено пакетное добавление внешних изображений по списку URL.



## Принцип работы

Расширение не копирует внешний файл изображения на сервер phpBB.

В базе данных сохраняются ссылка на полноразмерное изображение, миниатюра, название, описание и ссылка на исходную страницу.

Поэтому фотография может оставаться на исходном сервере, а пользователь видит её внутри интерфейса phpBB Gallery.

## XenForo Media Gallery

Для отдельной фотографии можно указать URL страницы XFMG вместо прямой ссылки на файл.

Например:

https://example.com/index.php?media/photo-name.123/

Расширение определит реальный URL изображения и получит доступные метаданные.

Для переноса целого альбома достаточно указать ссылку вида:

https://example.com/index.php?media/alb ... -name.123/

Расширение самостоятельно найдёт страницы фотографий во всём альбоме и последовательно импортирует их в выбранный альбом phpBB Gallery.

Исходные изображения при этом не скачиваются и остаются на сервере XenForo.

## Важно

Внешние изображения остаются зависимыми от исходного сайта.

Если исходный файл будет удалён, перемещён или станет недоступен, изображение перестанет отображаться и в phpBB Gallery.

### 0.3.1 — 2026-08-14

- Добавлен импорт категорий XenForo Media Gallery (XFMG).
- Один механизм импорта теперь поддерживает как альбомы, так и категории XenForo.
- Категории с большим количеством фотографий импортируются тем же порционным механизмом с автоматическим продолжением.
- Сохранена защита от повторного импорта уже добавленных фотографий.