| Resumen | Discourse Animated Avatars permite a los usuarios subir avatares animados en formato gif/webp que se animarán al pasar el cursor o al seleccionarlos en publicaciones, tarjetas de usuario y páginas de perfil. | |
| Enlace al repositorio | https://github.com/discourse/discourse-animated-avatars | |
| Guía de instalación | Cómo instalar plugins en Discourse |
Características
Por defecto, la animación se pausa cuando el elemento no está enfocado. Dentro de los temas, la animación se pausará cuando la publicación no esté seleccionada ni tenga el cursor encima.
animated_avatars_always_animate: anula el comportamiento de pausa anterior y fuerza que los avatares se animen siempre.
animated_avatars_min_trust_level_to_display restringe la animación de los avatares según el nivel de confianza.
Respeta la opción prefers-reduced-motion en las opciones de accesibilidad del navegador: las animaciones se desactivarán por completo.
Los gifs animados se convierten automáticamente a webp al subirlos, lo que reduce el tamaño total del archivo. Esto se puede configurar con animated_gif_avatar_to_webp (valor predeterminado: true).
Configuración
Este plugin tiene una dependencia opcional de gifsicle. Se utiliza para redimensionar las imágenes gif subidas para que encajen en un avatar cuadrado, lo que ayuda a controlar las proporciones y a normalizar las diferencias de tamaño entre las imágenes estáticas y animadas para un cambio más fluido. El plugin funcionará sin gifsicle, pero los avatares que no sean cuadrados pueden aparecer estirados al mostrarse.
gifsicle no es necesario para
animated_gif_avatar_to_webp. Los gifs animados se convertirán a webp con avatares cuadrados recortados.
Para habilitarlo, debes agregar una llamada al script de instalación en tu app.yml. Un ejemplo de cómo se vería el hook after_code es el siguiente:
hooks:
after_code:
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/discourse/discourse-animated-avatars.git
- exec:
cd: $home/plugins/discourse-animated-avatars
raise_on_fail: false
cmd:
- $home/plugins/discourse-animated-avatars/scripts/install.sh
Ajustes
| Nombre | Descripción |
|---|---|
| animated avatars min trust level to display | Nivel de confianza mínimo para mostrar un avatar animado |
| animated avatars always animate | Animar siempre los avatares |
| animated gif avatar to webp | Convierte automáticamente los avatares gif animados a webp al subirlos, reduciendo el tamaño del archivo. (predeterminado: true) |
| animated gif avatar webp quality | La calidad de la conversión de gif a webp. Ajustes recomendados entre el 75% y el 100% (predeterminado: 80%) |
Técnico
Se incluye una CLI adicional para ayudar a determinar la cantidad de avatares gif/webp y para convertir avatares gif existentes a webp.
bin/rake animated_avatars:count_animated cuenta el número total de avatares animados, agrupados por gif/webp.
bin/rake animated_avatars:gif_to_webp convierte los avatares gif animados existentes a webp. Los nuevos avatares se aplican automáticamente y los avatares gif existentes se eliminan mediante el trabajo CleanUpUploads.

