Плагин AIXF Media360 2.0.1 beta

Обязательно делайте резервные копии!

ПРИМЕЧАНИЕ: У меня нет устройств Apple, поэтому я не тестировал их на устройствах Apple. Одна из причин, по которой это бета-версия. Функция не работает в режиме лайтбокса. Вам придётся просматривать их без него.

# AIXF Media360 — 360° панорамы для медиагалереи XenForo

AIXF Media360 делает 360° (равноугольные) изображения естественными в медиагалерее XenForo.
Она распознаёт панорамные изображения и заменяет статичные фотографии интерактивным, перетаскиваемым 360° просмотрщиком (на базе Pannellum) — прямо в стандартном окне просмотра медиафайлов.

Вставка; без необходимости редактирования основного файла
Управление масштабом и полноэкранным режимом
Плавный автоматический поворот (опционально)
Работает с обычными равноугольными JPG-файлами (соотношение сторон 2:1), например, 4096×2048 или 8192×4096
CDN или локальные ресурсы (на ваш выбор)
---
## Установка
1. Загрузите ZIP-архив релиза через Панель управления администратора → Дополнения → Установка/обновление из архива.
2. После установки перейдите в Галерею медиа → любое изображение, представляющее собой равнопрямоугольную панораму (2:1).
Вы должны увидеть функции перетаскивания, масштабирования и полноэкранного режима.

### Использование CDN (по умолчанию)
Дополнение загружает Pannellum из общедоступной CDN. Дополнительные файлы и действия не требуются.

### Использование локальных файлов (необязательно)
Если ваш CSP блокирует CDN:

- Поместите локальные файлы Pannellum в дополнение (они включены, если вы использовали «локальную» сборку):
- В разделе ACP → Параметры → AIXF Media360 (если вы указали соответствующий параметр) установите «Использовать CDN» = «Выкл.».
Если вы не добавили параметр ACP, установите data-cdn="0" при монтировании (см. «Как это работает»).

---

## Как это работает (краткая версия)

На странице просмотра медиафайлов (public:xfmg_media_view) дополнение внедряет небольшой div-элемент монтирования и загрузочный скрипт.
Скрипт ожидает оригинальный <img>, проверяет его соотношение сторон ~2:1, скрывает его и монтирует Pannellum с тем же URL-адресом изображения.
Вы можете управлять поведением с помощью флагов data-* при монтировании.

Пример монтирования (уже внедрен дополнением; показан здесь для справки):
---

## Рекомендуемые размеры изображений

4096×2048 (4K) — наилучшая совместимость с устройствами

8192×4096 (8K) — более чёткое изображение на компьютере; файлы большего размера

Тип файла: JPG (стандартный равнопрямоугольный).

EXR/HDR не требуются для этого средства просмотра (можно использовать JPG с тональной компрессией).

---

## Устранение неполадок

Я вижу только неподвижное изображение.
Скорее всего, изображение не имеет соотношение сторон ~2:1. Проверьте размеры (например, 4096×2048). Вы можете увеличить допустимое отклонение соотношения данных (например, 0,08), если исходное соотношение немного отличается от 2:1.

Я могу перетаскивать, но кнопки не работают.
CSS-код Pannellum не загружен. Если вы используете CDN, убедитесь, что он не заблокирован. В локальном режиме убедитесь, что этот URL работает в вашем браузере:
Консоль выводит ошибку 404 для init.js или pannellum.js.

• Использование <xf:js src="aixf/media360/init.js" /> является правильным (не добавляйте префикс js/).
• Если вы создали собственный ZIP-архив, убедитесь, что ваш релиз включает:

CDN заблокирован CSP.
Переключитесь в локальный режим (см. выше) или ослабьте CSP для домена CDN.

Предупреждения о отложенной загрузке.
Скрипт ожидает завершения загрузки самого <img>; отложенная загрузка допустима. Если ваша тема поздно подменяет узел изображения, может возникнуть кратковременное мерцание.

---

## Roadmap (на основе обратной связи)

Обнаружение EXIF GPano/XMP (соотношение больше 2:1)
Мобильный гироскоп (orientationOnByDefault)
Глубинные ссылки «Поделиться этим видом» (yaw/pitch/hfov в URL)
Актуальные области (заголовки/ссылки)
Дополнительная поддержка XenAddons Showcase