 |
Résumé | Discourse Animated Avatars permet aux utilisateurs de télécharger des avatars animés au format gif/webp, qui s’animeront au survol ou à la sélection dans les publications, les cartes utilisateurs et les pages de profil. |
 |
Lien du dépôt | https://github.com/discourse/discourse-animated-avatars |
 |
Guide d’installation | Comment installer des plugins dans Discourse |
Fonctionnalités
Par défaut, l’animation est en pause lorsque l’élément n’est pas focalisé. Dans les sujets, l’animation est en pause lorsque la publication n’est pas survolée ou sélectionnée.
animated_avatars_always_animate : annule la mise en pause ci-dessus et force les avatars à s’animer en permanence.
animated_avatars_min_trust_level_to_display : restreint l’animation des avatars en fonction du niveau de confiance.
Respecte l’option d’accessibilité « prefers-reduced-motion » du navigateur : les animations seront désactivées entièrement.
Les gifs animés sont automatiquement convertis en webp lors du téléversement, réduisant ainsi la taille globale des fichiers. Cela peut être configuré avec animated_gif_avatar_to_webp (valeur par défaut : true).
Configuration
Ce plugin a une dépendance optionnelle envers gifsicle. Celui-ci est utilisé pour redimensionner les images gif téléversées afin qu’elles s’adaptent à un avatar carré, ce qui aide à maîtriser les rapports d’aspect ainsi qu’à normaliser les différences de taille entre les images statiques et animées pour un basculement plus fluide. Le plugin fonctionnera toujours sans gifsicle, mais les avatars non carrés peuvent apparaître étirés à l’affichage.
animated_gif_avatar_to_webp. Les gifs animés seront convertis en webp avec des avatars carrés recadrés.
Pour l’activer, vous devrez ajouter un appel au script d’installation dans votre app.yml. Un exemple de ce à quoi ressemblerait le hook after_code est le suivant :
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
Paramètres
| Nom | Description |
|---|---|
| animated avatars min trust level to display | Niveau de confiance minimal pour afficher un avatar animé |
| animated avatars always animate | Toujours animer les avatars |
| animated gif avatar to webp | Convertit automatiquement les avatars gif animés en webp lors du téléversement, réduisant la taille des fichiers. (valeur par défaut : true) |
| animated gif avatar webp quality | La qualité de la conversion de gif en webp. Réglages recommandés entre 75 % et 100 % (valeur par défaut : 80 %) |
Technique
Une CLI supplémentaire est incluse pour aider à déterminer le nombre d’avatars gif/webp et à convertir les avatars gif existants en webp.
bin/rake animated_avatars:count_animated compte le nombre total d’avatars animés, groupés par gif/webp
bin/rake animated_avatars:gif_to_webp convertit les avatars gif animés existants en webp. Les nouveaux avatars sont appliqués automatiquement et les avatars gif existants sont supprimés par le travail CleanUpUploads.