- Compatibilidade com XF
- 2.3.x
- Descrição curta
- AIXF Media360 — Enhance your XenForo media gallery with 360° panoramic images. Drop-in, no core edits needed; zoom, fullscreen controls, and auto-rotate options included for seamless viewing experience. Supports both CDN and local assets.
INSTRUÇÕES CRÍTICAS:
1. SOMENTE output o texto traduzido. Sem aspas, sem raios de ar, sem wrappers.
2. NUNCA adicione notas, explicações ou introduções.
3. NUNCA envolva o output em <> "", ou qualquer outro separador.
4. MANEIRAS PROPRAS (nomes de produtos) devem permanecer em seu formato original quando apropriado.
# AIXF Media360 — Panorâmicas 360° para a Galeria de Mídia do XenForo
AIXF Media360 torna as imagens panorâmicas 360° sentir-se nativas na Galeria de Mídia do XenForo.
Ele detecta imagens panorâmicas e substitui a foto estática por um visual interativo, draggable e 360° (powered pelo Pannellum) — direto dentro da visão padrão de mídia.
✅ Drop-in; sem edições de arquivo do núcleo
✅ Controles de zoom e fullscreen
✅ Rotacionamento suave automático (opcional)
✅ Funciona com JPG panorâmico plano (aspecto 2:1), por exemplo, 4096×2048 ou 8192×4096
✅ CDN ou arquivos locais (você escolhe)
---
## INSTALAÇÃO
1. Carregue o ZIP de release via Admin CP → Adicionais → Instalar/actualizar a partir do arquivo.
2. Depois da instalação, visite a Galeria de Mídia → qualquer imagem que seja uma panorâmica equirectangular (aspecto 2:1).
Você deve ver o drag-to-look, mais controles de zoom e fullscreen.
### Usando CDN (padrão)
O adendo carrega o Pannellum do um CDN público. Nenhum arquivo extra ou passos adicionais são necessários.
### Usando arquivos locais (opcional)
Se seu CSP bloqueia CDNs:
- Coloque os arquivos locais do Pannellum no adendo (estes estão incluídos se você usou a “local” de construção):
/js/aixf/media360/pannellum.min.js
/styles/aixf/media360/pannellum.css
- No ACP → Opções → AIXF Media360 (se expôs uma opção), defina Use CDN = Off.
Se você não adicionou uma opção de ACP, defina data-cdn="0" no monte (veja "Como funciona").
## Como funciona (versão curta)
Na página da visão de mídia (public:xfmg_media_view), o adendo injeta um pequeno div de montagem e um script de inicialização.
O script aguarda pelo <img> original, verifica se é ~2:1, oculta-o e monta o Pannellum com a mesma URL da imagem.
Tamanos recomendados de imagem
EXR/HDR não são necessários para este visualizador (você pode usar JPG tonemapped).Imagem ainda estáticaMais provavelmente a imagem não é ~2:1. Verifique as dimensões (ex.: 4096×2048). Você pode aumentar o data-ratio-tolerance (ex. 0.08) se sua fonte estiver ligeiramente fora do 2:1.Eu posso arrastar, mas não há botões.PannellumCSSNão está carregado. Se você estiver usando CDN, certifique-se de que não foi bloqueado. Para modo local, confirme que essa URL funciona no seu navegador:
1. SOMENTE output o texto traduzido. Sem aspas, sem raios de ar, sem wrappers.
2. NUNCA adicione notas, explicações ou introduções.
3. NUNCA envolva o output em <> "", ou qualquer outro separador.
4. MANEIRAS PROPRAS (nomes de produtos) devem permanecer em seu formato original quando apropriado.
# AIXF Media360 — Panorâmicas 360° para a Galeria de Mídia do XenForo
AIXF Media360 torna as imagens panorâmicas 360° sentir-se nativas na Galeria de Mídia do XenForo.
Ele detecta imagens panorâmicas e substitui a foto estática por um visual interativo, draggable e 360° (powered pelo Pannellum) — direto dentro da visão padrão de mídia.
✅ Drop-in; sem edições de arquivo do núcleo
✅ Controles de zoom e fullscreen
✅ Rotacionamento suave automático (opcional)
✅ Funciona com JPG panorâmico plano (aspecto 2:1), por exemplo, 4096×2048 ou 8192×4096
✅ CDN ou arquivos locais (você escolhe)
---
## INSTALAÇÃO
1. Carregue o ZIP de release via Admin CP → Adicionais → Instalar/actualizar a partir do arquivo.
2. Depois da instalação, visite a Galeria de Mídia → qualquer imagem que seja uma panorâmica equirectangular (aspecto 2:1).
Você deve ver o drag-to-look, mais controles de zoom e fullscreen.
### Usando CDN (padrão)
O adendo carrega o Pannellum do um CDN público. Nenhum arquivo extra ou passos adicionais são necessários.
### Usando arquivos locais (opcional)
Se seu CSP bloqueia CDNs:
- Coloque os arquivos locais do Pannellum no adendo (estes estão incluídos se você usou a “local” de construção):
/js/aixf/media360/pannellum.min.js
/styles/aixf/media360/pannellum.css
- No ACP → Opções → AIXF Media360 (se expôs uma opção), defina Use CDN = Off.
Se você não adicionou uma opção de ACP, defina data-cdn="0" no monte (veja "Como funciona").
## Como funciona (versão curta)
Na página da visão de mídia (public:xfmg_media_view), o adendo injeta um pequeno div de montagem e um script de inicialização.
O script aguarda pelo <img> original, verifica se é ~2:1, oculta-o e monta o Pannellum com a mesma URL da imagem.
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>- []*4096x2048(4K)melhor compatibilidade entre dispositivos[]*8192x4096 (8K)— mais aguçado para desktop; arquivos maiores
EXR/HDR não são necessários para este visualizador (você pode usar JPG tonemapped).Imagem ainda estáticaMais provavelmente a imagem não é ~2:1. Verifique as dimensões (ex.: 4096×2048). Você pode aumentar o data-ratio-tolerance (ex. 0.08) se sua fonte estiver ligeiramente fora do 2:1.Eu posso arrastar, mas não há botões.PannellumCSSNão está carregado. Se você estiver usando CDN, certifique-se de que não foi bloqueado. Para modo local, confirme que essa URL funciona no seu navegador:
Consoles mostram 404 para init.js ou pannellum.js.
- []*Usando<xf:js src="aixf/media360/init.js"/> é correto (não prefixar com js/).[Se você construiu seu próprio ZIP, garanta que a sua release inclua:
CSP bloqueado pelo CDN.Mudar paralocalmodo (acima), ou relaxe o CSP para o domínio CDN.Aviso de carregamento atrasado.O script espera que o <img> realmente carregue; o lazy-loading é válido. Se sua tema troca o nó de imagem tarde, pode acontecer um curto piscar.Roteiro (feedback-baseado)
- GPano/XMP Detecção de Exif além do rácio 2:1
- Giróscopo móvel (orientaçãoPorDefinição)
- “Compartilhe essa visão” links de compartilhamento (yaw/pitch/hfov em URL)
- Pontos Quentes (títulos/links)
- OpcionalShowcase XenAddonssuporte
![[AndyB] Convert image media gallery](/data/resource_icons/7/7400.jpg?1720149273){kind=icon}
![[AndyB] Convert image media gallery all](/data/resource_icons/14/14460.jpg?1720149306){kind=icon}
![[AndyB] Featured media](/data/resource_icons/1/1409.jpg?1720149245){kind=icon}