Moetwemoji : Emojis animés légers (AVIF) - Animez votre forum

Greffon
3

OK, veuillez essayer l’installation manuelle

Guide d’installation manuelle (Version de substitution)

Ce guide explique comment installer et appliquer manuellement le plugin discourse-moetwemoji-twemoji-fakepng-override à l’intérieur d’un conteneur Discourse en cours d’exécution, et clarifie pourquoi une reconstruction complète n’est pas strictement nécessaire pour la version de substitution.

1. Entrer dans le Conteneur Discourse

Sur votre serveur, accédez au répertoire Docker de Discourse (généralement /var/discourse) et entrez dans le conteneur en cours d’exécution :

cd /var/discourse
./launcher enter app

Vous devriez maintenant être dans le shell du conteneur.

2. Cloner le Plugin de Substitution Manuellement

Accédez au répertoire des plugins et clonez le dépôt :

cd /var/www/discourse/plugins
git clone https://github.com/constansino/discourse-moetwemoji-twemoji-fakepng-override.git

Vérifiez que le répertoire existe :

ls discourse-moetwemoji-twemoji-fakepng-override

3. Appliquer la Substitution d’Emoji

Retournez au répertoire racine de Discourse :

su - discourse
cd /var/www/discourse

Vérifiez l’état actuel (facultatif mais recommandé) :

RAILS_ENV=production bundle exec rake moetwemoji_twemoji:status

Appliquez la substitution :

RAILS_ENV=production bundle exec rake moetwemoji_twemoji:apply

Si la commande se termine sans erreur, les fichiers PNG Twemoji ont été remplacés par Moetwemoji.

4. Notes Importantes Concernant les Reconstructions (Persistance)

:red_exclamation_mark: Aucune reconstruction n’est nécessaire pour que la substitution fonctionne

Cette version de substitution fonctionne en remplaçant directement les fichiers dans le conteneur en cours d’exécution.
Par conséquent :

  • :white_check_mark: Vous n’avez PAS besoin d’exécuter ./launcher rebuild app

  • :white_check_mark: Les changements prennent effet immédiatement après l’exécution de la tâche rake

:warning: Mais le changement N’EST PAS persistant

Parce que cela est fait à l’intérieur du système de fichiers du conteneur :

  • Toute future exécution de ./launcher rebuild app

  • Ou recréation/mise à jour du conteneur

effacera les changements, et la substitution d’emoji sera perdue.

:backhand_index_pointing_right: Si vous avez besoin de persistance à travers les reconstructions, vous devez installer le plugin via les hooks app.yml et reconstruire correctement.

5. Vider le Cache CDN et le Cache du Navigateur (Très Important)

Après avoir appliqué la substitution, les emojis peuvent toujours apparaître inchangés en raison de la mise en cache.

5.1 Vider le Cache CDN (ex: Cloudflare)

Si vous utilisez un CDN tel que Cloudflare :

  • Purgez le cache pour :

    • /images/emoji/*

    • ou effectuez une purge complète du cache si nécessaire

Sinon, les anciens fichiers PNG Twemoji pourraient toujours être servis.

5.2 Vider le Cache du Navigateur

Du côté client :

  • Actualisation forcée de la page (Ctrl + F5 / Cmd + Shift + R)

  • Ou vider le cache du navigateur

  • Ou tester dans une fenêtre de navigation privée/incognito

Tant que les caches CDN et du navigateur ne sont pas vidés, les changements d’emoji pourraient ne pas être visibles.

6. Résumé

  • Ce plugin de substitution peut être installé et appliqué sans reconstruction

  • L’installation manuelle est utile pour :

    • Les tests

    • L’utilisation temporaire

    • Le débogage

  • L’inconvénient est le manque de persistance

  • Toujours vider le cache CDN + cache du navigateur après avoir appliqué les substitutions d’emoji