 |
Sommario | Discourse Animated Avatars aggiunge la possibilità per gli utenti di caricare avatar animati in formato gif/webp, che si animeranno al passaggio del mouse o alla selezione nei post, nelle schede utente e nelle pagine profilo. |
 |
Link al repository | https://github.com/discourse/discourse-animated-avatars |
 |
Guida all’installazione | Come installare i plugin in Discourse |
Funzionalità
Per impostazione predefinita, l’animazione si mette in pausa quando l’elemento non è focalizzato. All’interno dei topic, l’animazione si metterà in pausa quando il post non viene evidenziato al passaggio del mouse o non è selezionato.
animated_avatars_always_animate: sostituisce la messa in pausa descritta sopra, forzando gli avatar ad animarsi sempre.
animated_avatars_min_trust_level_to_display limita l’animazione degli avatar in base al livello di fiducia.
Rispetta l’impostazione prefers-reduced-motion nelle opzioni di accessibilità del browser: le animazioni verranno disabilitate completamente.
Le gif animate vengono convertite automaticamente in webp al caricamento, riducendo la dimensione complessiva del file. Questo può essere configurato con animated_gif_avatar_to_webp (valore predefinito: true).
Configurazione
Questo plugin ha una dipendenza opzionale da gifsicle. Viene utilizzato per ridimensionare le immagini gif caricate per adattarle a un avatar quadrato, il che aiuta a gestire i rapporti di aspetto e a normalizzare le differenze di dimensione tra le immagini statiche e animate per un passaggio più fluido. Il plugin funzionerà comunque senza di esso, ma gli avatar non quadrati potrebbero apparire distesi quando visualizzati.
animated_gif_avatar_to_webp. Le gif animate verranno convertite in webp con avatar quadrati ritagliati.
Per abilitarlo, è necessario aggiungere una chiamata allo script di installazione nel file app.yml. Un esempio di come apparirà l’hook after_code è il seguente:
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
Impostazioni
| Nome | Descrizione |
|---|---|
| animated avatars min trust level to display | Livello di fiducia minimo per visualizzare un avatar animato |
| animated avatars always animate | Anima sempre gli avatar |
| animated gif avatar to webp | Converte automaticamente gli avatar gif animati in webp al caricamento, riducendo la dimensione del file. (predefinito: true) |
| animated gif avatar webp quality | La qualità della conversione da gif a webp. Impostazioni consigliate tra il 75% e il 100% (predefinito: 80%) |
Tecnico
È inclusa una CLI aggiuntiva per aiutare a determinare il numero di avatar gif/webp e per convertire gli avatar gif esistenti in webp.
bin/rake animated_avatars:count_animated conta il numero totale di avatar animati, raggruppati per formato gif/webp
bin/rake animated_avatars:gif_to_webp converte gli avatar gif animati esistenti in webp. I nuovi avatar vengono applicati automaticamente e gli avatar gif esistenti vengono rimossi dal job CleanUpUploads.