Moetwemoji: Emoji animati leggeri (AVIF) - Dai vita al tuo forum

Plugin
3

OK, prova l’installazione manuale

Guida all’installazione manuale (Versione di Override)

Questa guida spiega come installare e applicare manualmente il plugin discourse-moetwemoji-twemoji-fakepng-override all’interno di un container Discourse in esecuzione, e chiarisce perché una ricostruzione completa non è strettamente necessaria per la versione di override.

1. Entra nel Container di Discourse

Sul tuo server, vai alla directory Docker di Discourse (di solito /var/discourse) ed entra nel container in esecuzione:

cd /var/discourse
./launcher enter app

Ora dovresti essere all’interno della shell del container.

2. Clona il Plugin di Override Manualmente

Naviga nella directory dei plugin e clona il repository:

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

Verifica che la directory esista:

ls discourse-moetwemoji-twemoji-fakepng-override

3. Applica l’Override delle Emoji

Torna alla directory principale di Discourse:

su - discourse
cd /var/www/discourse

Controlla lo stato attuale (opzionale ma consigliato):

RAILS_ENV=production bundle exec rake moetwemoji_twemoji:status

Applica l’override:

RAILS_ENV=production bundle exec rake moetwemoji_twemoji:apply

Se il comando termina senza errori, i file PNG di Twemoji sono stati sostituiti da Moetwemoji.

4. Note Importanti sulle Ricostruzioni (Persistenza)

:red_exclamation_mark: Nessuna ricostruzione è necessaria per far funzionare l’override

Questa versione di override funziona sostituendo direttamente i file nel container in esecuzione.
Pertanto:

  • :white_check_mark: NON è necessario eseguire ./launcher rebuild app

  • :white_check_mark: Le modifiche hanno effetto immediatamente dopo l’esecuzione del task rake

:warning: Ma la modifica NON è persistente

Poiché questo viene fatto all’interno del filesystem del container:

  • Qualsiasi futura esecuzione di ./launcher rebuild app

  • O ricreazione/aggiornamento del container

cancellerà le modifiche, e l’override delle emoji andrà perso.

:backhand_index_pointing_right: Se hai bisogno di persistenza tra le ricostruzioni, devi installare il plugin tramite gli hook di app.yml e ricostruire correttamente.

5. Svuota la Cache CDN e del Browser (Molto Importante)

Dopo aver applicato l’override, le emoji potrebbero apparire ancora invariate a causa della memorizzazione nella cache.

5.1 Svuota la Cache CDN (es. Cloudflare)

Se stai utilizzando un CDN come Cloudflare:

  • Svuota la cache per:

    • /images/emoji/*

    • o esegui una cancellazione completa della cache se necessario

Altrimenti, i vecchi file PNG di Twemoji potrebbero essere ancora serviti.

5.2 Svuota la Cache del Browser

Sul lato client:

  • Aggiornamento forzato della pagina (Ctrl + F5 / Cmd + Shift + R)

  • O svuota la cache del browser

  • O prova in una finestra in incognito/privata

Finché la cache CDN e quella del browser non saranno state svuotate, le modifiche alle emoji potrebbero non essere visibili.

6. Riepilogo

  • Questo plugin di override può essere installato e applicato senza ricostruire

  • L’installazione manuale è utile per:

    • Test

    • Uso temporaneo

    • Debug

  • Lo svantaggio è la mancanza di persistenza

  • Svuota sempre la cache CDN + cache del browser dopo aver applicato gli override delle emoji