- Compatibilidad con XF
- 2.3.x
- Descripción breve
- 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.
INSTRUCCIONES CRÍTICAS:
1. SÓLO output el texto traducido. No quotes, ni guiones altos, ni marcos de formato.
2. NO añadas notas, explicaciones o frase inicial.
3. NO envuelvas el output en <>, "", o cualquier otro marcador.
4. MANTIENE los nombres propios (nombres de marcas, productos) en su forma original cuando sea apropiado.
NOTA: No poseo nada Apple, así que no he probado nada Apple. Parte del motivo por qué está en versión beta. Esto no funciona en el lightbox. Tienes que verlos sin él.
# AIXF Media360 — 360° Panoramas para la Galería de Medios de XenForo
AIXF Media360 hace que las imágenes 360° (ecuarteórica) se sientan nativas en la Galería de Medios de XenForo.
Detecta imágenes panorámicas y reemplaza la foto estática con un espectador interactivo, deslizante de 360° (poderado por Pannellum) — justo dentro del vista estándar de los medios.
✅ Descarga directa; sin ediciones de archivo en el núcleo
✅ Controles de zoom y pantalla completa
✅ Rotación automática suave (opcional)
✅ Funciona con JPG ecuarteórica simple (aspecto 2:1), por ejemplo, 4096×2048 o 8192×4096
✅ Recursos CDN o archivos locales (tus elecciones)
---
## Instalación
1. Sube el archivo ZIP de la versión a través del CP Administrador → Añadir complementos → Instalar/actualizar desde archivo.
2. Después de la instalación, visita la Galería de Medios → cualquier imagen que sea una panorámica ecuarteórica (aspecto 2:1).
Deberías ver el deslizamiento para mirar, más los controles de zoom y pantalla completa.
### Usando CDN (por defecto)
El complemento carga Pannellum desde un CDN público. No hay archivos extra ni pasos adicionales.
### Usando archivos locales (opcional)
Si tu CSP bloquea los CDNs:
- Coloca los archivos locales de Pannellum en el complemento (estos están incluidos si usaste la versión "local"):
/js/aixf/media360/pannellum.min.js
/styles/aixf/media360/pannellum.css
- En ACP → Opciones → AIXF Media360 (si expusiste una opción), establece Use CDN = Off.
Si no agregaste una opción en ACP, establece data-cdn="0" en el montaje (ver "Cómo funciona").
## Cómo funciona (versión corta)
En la página de vista de medios (publico:xfmg_media_view), el complemento inyecta un pequeño div de montaje y un script de arranque.
El script espera por el <img> original, verifica si es aproximadamente 2:1, lo oculta y monta Pannellum con la misma URL del imagen.
Puedes controlar el comportamiento a través de flags data-* en el div de montaje.
Tamales recomendados de imágenes
EXR/HDR no son necesarios para este vistalizer (puedes usar JPG tonemapped).¡Imágenes fijas!La imagen no es probablemente ~2:1. Comprueba las dimensiones (ejemplo, 4096×2048). Puedes ampliar data-ratio-tolerance (ejemplo, 0.08) si tu fuente está ligeramente desviada del 2:1.Puedo arrastrar, pero no hay botones.PannellumCSSno está cargado. Si estás en CDN, asegúrate de que no esté bloqueado. Para modo local, confirma que este URL funcione en tu navegador:
1. SÓLO output el texto traducido. No quotes, ni guiones altos, ni marcos de formato.
2. NO añadas notas, explicaciones o frase inicial.
3. NO envuelvas el output en <>, "", o cualquier otro marcador.
4. MANTIENE los nombres propios (nombres de marcas, productos) en su forma original cuando sea apropiado.
NOTA: No poseo nada Apple, así que no he probado nada Apple. Parte del motivo por qué está en versión beta. Esto no funciona en el lightbox. Tienes que verlos sin él.
# AIXF Media360 — 360° Panoramas para la Galería de Medios de XenForo
AIXF Media360 hace que las imágenes 360° (ecuarteórica) se sientan nativas en la Galería de Medios de XenForo.
Detecta imágenes panorámicas y reemplaza la foto estática con un espectador interactivo, deslizante de 360° (poderado por Pannellum) — justo dentro del vista estándar de los medios.
✅ Descarga directa; sin ediciones de archivo en el núcleo
✅ Controles de zoom y pantalla completa
✅ Rotación automática suave (opcional)
✅ Funciona con JPG ecuarteórica simple (aspecto 2:1), por ejemplo, 4096×2048 o 8192×4096
✅ Recursos CDN o archivos locales (tus elecciones)
---
## Instalación
1. Sube el archivo ZIP de la versión a través del CP Administrador → Añadir complementos → Instalar/actualizar desde archivo.
2. Después de la instalación, visita la Galería de Medios → cualquier imagen que sea una panorámica ecuarteórica (aspecto 2:1).
Deberías ver el deslizamiento para mirar, más los controles de zoom y pantalla completa.
### Usando CDN (por defecto)
El complemento carga Pannellum desde un CDN público. No hay archivos extra ni pasos adicionales.
### Usando archivos locales (opcional)
Si tu CSP bloquea los CDNs:
- Coloca los archivos locales de Pannellum en el complemento (estos están incluidos si usaste la versión "local"):
/js/aixf/media360/pannellum.min.js
/styles/aixf/media360/pannellum.css
- En ACP → Opciones → AIXF Media360 (si expusiste una opción), establece Use CDN = Off.
Si no agregaste una opción en ACP, establece data-cdn="0" en el montaje (ver "Cómo funciona").
## Cómo funciona (versión corta)
En la página de vista de medios (publico:xfmg_media_view), el complemento inyecta un pequeño div de montaje y un script de arranque.
El script espera por el <img> original, verifica si es aproximadamente 2:1, lo oculta y monta Pannellum con la misma URL del imagen.
Puedes controlar el comportamiento a través de flags data-* en el div de montaje.
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)mejor compatibilidad entre dispositivos[]*8192x4096 (8K)— más agudo en escritorio; archivos grandes
EXR/HDR no son necesarios para este vistalizer (puedes usar JPG tonemapped).¡Imágenes fijas!La imagen no es probablemente ~2:1. Comprueba las dimensiones (ejemplo, 4096×2048). Puedes ampliar data-ratio-tolerance (ejemplo, 0.08) si tu fuente está ligeramente desviada del 2:1.Puedo arrastrar, pero no hay botones.PannellumCSSno está cargado. Si estás en CDN, asegúrate de que no esté bloqueado. Para modo local, confirma que este URL funcione en tu navegador:
El console muestra un 404 para init.js o pannellum.js.
- []*Usando <xf:js src="aixf/media360/init.js" /> es correcto (no preceder con js/).[Si construiste tu propio ZIP, asegúrate de que tu liberación incluya:
CDN bloqueado por CSP.Cambiar alocalmodo (ver arriba), o suelte el CSP para el dominio CDN.Alertas de carga tardía.El script espera que el elemento <img> se complete la carga; el lazy-loading es aceptable. Si su tema intercambia el nodo de imagen tarde, puede haber un corto destello.Ruta de Acción (frente a la retroalimentación)
- []*GPano/XMP detección de EXIF (supera el ratio 2:1)*[*Móvil giroscopio (orientaciónOnPorDefecto)
- “Compartir esta vista” enlaces de profundización (yaw/pitch/hfov en URL)[]*Hotspots (títulos/enlaces)[]*OpcionalXenAddons Showcasesoporte
![[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}