Moetwemoji: Emojis Animados Leves (AVIF) - Dê vida ao seu fórum

Plugin
3

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)

:red_exclamation_mark: 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:

  • :white_check_mark: Você NÃO precisa executar ./launcher rebuild app

  • :white_check_mark: As alterações entram em vigor imediatamente após a execução da tarefa rake

:warning: Mas a alteração NÃO é persistente

Como isso é feito dentro do sistema de arquivos do contêiner:

  • Qualquer ./launcher rebuild app futuro

  • Ou recriação/atualização do contêiner

irá apagar as alterações, e a substituição de emoji será perdida.

:backhand_index_pointing_right: 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:

  • Exclua o cache para:

    • /images/emoji/*

    • ou execute uma limpeza completa do cache, se necessário

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