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)
Nessuna ricostruzione è necessaria per far funzionare l’override
Questa versione di override funziona sostituendo direttamente i file nel container in esecuzione.
Pertanto:
Ma la modifica NON è persistente
Poiché questo viene fatto all’interno del filesystem del container:
cancellerà le modifiche, e l’override delle emoji andrà perso.
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:
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