- Совместимость с XenForo
- 2.3
- Видимый копирайт
- Нет
## Requirements
- XenForo **2.3.7+**
- XenForo Media Gallery **2.3.7+**
- PHP 8.1+ (tested on 8.2)
Обязательно делайте резервные копии!
ПРИМЕЧАНИЕ: У меня нет ничего от Apple, поэтому я не тестировал это на устройствах Apple. Отчасти поэтому это бета-версия. Это не работает в лайтбоксе. Вам придётся просматривать их без него.
# AIXF Media360 — панорамы 360° для медиагалереи XenForo. Благодаря
AIXF Media360 360-градусные (равнопрямоугольные) изображения выглядят естественно в медиагалерее XenForo.
Он распознаёт панорамные изображения и заменяет статичные фотографии интерактивным , перетаскиваемым 360-градусным просмотрщиком (на базе Pannellum) — прямо внутри стандартного медиаокна.
---
## Установка
1. Загрузите ZIP-файл релиза через Admin CP → Плагины → Установка/обновление из архива .
2. После установки перейдите в Media Gallery → любое изображение , представляющее собой равнопрямоугольную панораму (2:1).
Вы должны увидеть функции перетаскивания, масштабирования и полноэкранного режима .
### Использование CDN (по умолчанию)
Дополнение загружает Pannellum из общедоступной CDN. Никаких дополнительных файлов или действий.
### Использование локальных файлов (необязательно)
Если ваш CSP блокирует CDN:
- Поместите локальные файлы Pannellum в дополнение (они включены, если вы использовали «локальную» сборку):
- В ACP → Параметры → AIXF Media360 (если вы указали соответствующий параметр), установите Use CDN = Off.
Если вы не добавили параметр ACP, установите его data-cdn="0"в монтировании (см. «Как это работает»).
---
## Как это работает (краткая версия)
Пример монтирования (уже внедрен дополнением; показан здесь для справки):
---
## Рекомендуемые размеры изображения
Тип файла: JPG (стандартный равнопрямоугольный).
EXR/HDR не требуются для этого средства просмотра (можно использовать JPG с тональной компрессией).
---
## Устранение неполадок
Я вижу только неподвижное изображение.
Скорее всего, изображение не имеет соотношение сторон ~2:1. Проверьте размеры (например, 4096×2048). Вы можете расширить data-ratio-tolerance(например 0.08, ), если исходное изображение немного отличается от соотношения 2:1.
Я могу перетаскивать изображение, но кнопки недоступны. CSS-код
Pannellum не загружен. Если вы используете CDN, убедитесь, что он не заблокирован. В локальном режиме убедитесь, что этот URL-адрес работает в вашем браузере:
Консоль показывает 404 для init.js или pannellum.js.
CDN заблокирован CSP.
Переключитесь в локальный режим (см. выше) или ослабьте CSP для домена CDN.
Предупреждения о отложенной загрузке.
Скрипт ожидает <img>завершения фактической загрузки; отложенная загрузка допустима. Если ваша тема поздно подменяет узел изображения, может возникнуть кратковременное мерцание.
---
## Дорожная карта (на основе отзывов)
- XenForo **2.3.7+**
- XenForo Media Gallery **2.3.7+**
- PHP 8.1+ (tested on 8.2)
Обязательно делайте резервные копии!
ПРИМЕЧАНИЕ: У меня нет ничего от Apple, поэтому я не тестировал это на устройствах Apple. Отчасти поэтому это бета-версия. Это не работает в лайтбоксе. Вам придётся просматривать их без него.
# AIXF Media360 — панорамы 360° для медиагалереи XenForo. Благодаря
AIXF Media360 360-градусные (равнопрямоугольные) изображения выглядят естественно в медиагалерее XenForo.
Он распознаёт панорамные изображения и заменяет статичные фотографии интерактивным , перетаскиваемым 360-градусным просмотрщиком (на базе Pannellum) — прямо внутри стандартного медиаокна.
Вставка; редактирование основного файла не требуется- Управление масштабированием и полноэкранным режимом
- Плавный автоматический поворот (опционально)
- Работает с обычными JPG-файлами равнопрямоугольной формы (соотношение сторон 2:1), например, 4096×2048 или 8192×4096.
- CDN или локальные ресурсы (на ваш выбор)
---
## Установка
1. Загрузите ZIP-файл релиза через Admin CP → Плагины → Установка/обновление из архива .
2. После установки перейдите в Media Gallery → любое изображение , представляющее собой равнопрямоугольную панораму (2:1).
Вы должны увидеть функции перетаскивания, масштабирования и полноэкранного режима .
### Использование CDN (по умолчанию)
Дополнение загружает Pannellum из общедоступной CDN. Никаких дополнительных файлов или действий.
### Использование локальных файлов (необязательно)
Если ваш CSP блокирует CDN:
- Поместите локальные файлы Pannellum в дополнение (они включены, если вы использовали «локальную» сборку):
Код:
/js/aixf/media360/pannellum.min.js
/styles/aixf/media360/pannellum.cssЕсли вы не добавили параметр ACP, установите его data-cdn="0"в монтировании (см. «Как это работает»).
---
## Как это работает (краткая версия)
- На странице просмотра мультимедиа ( public:xfmg_media_view) дополнение внедряет небольшой div-элемент монтирования и загрузочный скрипт.
- Скрипт ждет оригинал <img>, проверяет, является ли он ~2:1 , скрывает его и монтирует Pannellum с тем же URL-адресом изображения.
- Управлять поведением можно с помощью data-*флагов на ездовом животном.
Пример монтирования (уже внедрен дополнением; показан здесь для справки):
HTML:
<div id="aixfPanoMount" class="js-aixf360"
data-enabled="1"
data-cdn="1" <!-- 1 = CDN (default), 0 = local -->
data-fov="75" <!-- initial zoom (HFOV) -->
data-autorotate="1.2" <!-- deg/sec; 0 = off -->
data-fullscreen="1" <!-- show fullscreen button -->
data-ratio-tolerance="0.05" <!-- 2:1 detection tolerance -->
style="width:100%;height:60vh"></div>---
## Рекомендуемые размеры изображения
- 4096×2048 (4K) — лучшая совместимость с устройствами
- 8192×4096 (8K) — чётче на десктопе; файлы большего размера
Тип файла: JPG (стандартный равнопрямоугольный).
EXR/HDR не требуются для этого средства просмотра (можно использовать JPG с тональной компрессией).
---
## Устранение неполадок
Я вижу только неподвижное изображение.
Скорее всего, изображение не имеет соотношение сторон ~2:1. Проверьте размеры (например, 4096×2048). Вы можете расширить data-ratio-tolerance(например 0.08, ), если исходное изображение немного отличается от соотношения 2:1.
Я могу перетаскивать изображение, но кнопки недоступны. CSS-код
Pannellum не загружен. Если вы используете CDN, убедитесь, что он не заблокирован. В локальном режиме убедитесь, что этот URL-адрес работает в вашем браузере:
Код:
/styles/aixf/media360/pannellum.cssКонсоль показывает 404 для init.js или pannellum.js.
- Использование <xf:js src="aixf/media360/init.js" />является правильным (не добавлять префикс js/).
- Если вы создали свой собственный ZIP-архив, убедитесь, что ваш релиз включает в себя:
Код:
upload/js/aixf/media360/init.jsCDN заблокирован CSP.
Переключитесь в локальный режим (см. выше) или ослабьте CSP для домена CDN.
Предупреждения о отложенной загрузке.
Скрипт ожидает <img>завершения фактической загрузки; отложенная загрузка допустима. Если ваша тема поздно подменяет узел изображения, может возникнуть кратковременное мерцание.
---
## Дорожная карта (на основе отзывов)
- Обнаружение EXIF GPano/XMP (выше соотношения 2:1)
- Мобильный гироскоп (orientationOnByDefault)
- Глубокие ссылки «Поделиться этим видом» (yaw/pitch/hfov в URL)
- Горячие точки (заголовки/ссылки)
- Дополнительная поддержка XenAddons Showcase
