OK, tente a Instalação Manual
Guia de Instalação Manual (Versão de Substituição)
Este guia explica como instalar e aplicar manualmente o plugin discourse-moetwemoji-twemoji-fakepng-override dentro de um contêiner Discourse em execução, e esclarece por que uma reconstrução completa não é estritamente necessária para a versão de substituição.
1. Entrar no Contêiner Discourse
No seu servidor, navegue até o diretório do Docker do Discourse (geralmente /var/discourse) e entre no contêiner em execução:
cd /var/discourse
./launcher enter app
Você deve estar agora dentro do shell do contêiner.
2. Clonar o Plugin de Substituição Manualmente
Navegue até o diretório de plugins e clone o repositório:
cd /var/www/discourse/plugins
git clone https://github.com/constansino/discourse-moetwemoji-twemoji-fakepng-override.git
Verifique se o diretório existe:
ls discourse-moetwemoji-twemoji-fakepng-override
3. Aplicar a Substituição de Emoji
Volte para o diretório raiz do Discourse:
su - discourse
cd /var/www/discourse
Verifique o status atual (opcional, mas recomendado):
RAILS_ENV=production bundle exec rake moetwemoji_twemoji:status
Aplique a substituição:
RAILS_ENV=production bundle exec rake moetwemoji_twemoji:apply
Se o comando for concluído sem erros, os arquivos PNG do Twemoji foram substituídos pelo Moetwemoji.
4. Notas Importantes Sobre Reconstruções (Persistência)
Nenhuma reconstrução é necessária para que a substituição funcione
Esta versão de substituição funciona substituindo diretamente os arquivos no contêiner em execução.
Portanto:
Mas a alteração NÃO é persistente
Como isso é feito dentro do sistema de arquivos do contêiner:
irá apagar as alterações, e a substituição de emoji será perdida.
Se você precisar de persistência entre reconstruções, você deve instalar o plugin através dos hooks do app.yml e reconstruir corretamente.
5. Limpar o Cache do CDN e do Navegador (Muito Importante)
Após aplicar a substituição, os emojis podem ainda aparecer inalterados devido ao cache.
5.1 Limpar o Cache do CDN (ex: Cloudflare)
Se você estiver usando um CDN como o Cloudflare:
Caso contrário, os arquivos PNG antigos do Twemoji podem continuar sendo servidos.
5.2 Limpar o Cache do Navegador
No lado do cliente:
-
Atualização forçada da página (Ctrl + F5 / Cmd + Shift + R)
-
Ou limpar o cache do navegador
-
Ou testar em uma janela anônima/privada
Até que os caches do CDN e do navegador sejam limpos, as alterações de emoji podem não ser visíveis.
6. Resumo
-
Este plugin de substituição pode ser instalado e aplicado sem reconstrução
-
A instalação manual é útil para:
-
Testes
-
Uso temporário
-
Depuração
-
A desvantagem é a falta de persistência
-
Sempre limpe o cache do CDN + cache do navegador após aplicar substituições de emoji