Moetwemoji: Leichte animierte Emojis (AVIF) - Beleben Sie Ihr Forum

Plugin
3

OK, versuchen Sie bitte die manuelle Installation

Manuelle Installationsanleitung (Override-Version)

Diese Anleitung erklärt, wie Sie das Plugin discourse-moetwemoji-twemoji-fakepng-override manuell installieren und anwenden, während sich ein Discourse-Container im Betrieb befindet, und klärt, warum ein vollständiger Neuaufbau (rebuild) für die Override-Version nicht zwingend erforderlich ist.

1. In den Discourse-Container wechseln

Gehen Sie auf Ihrem Server in das Discourse Docker-Verzeichnis (normalerweise /var/discourse) und betreten Sie den laufenden Container:

cd /var/discourse
./launcher enter app

Sie sollten sich nun in der Container-Shell befinden.

2. Das Override-Plugin manuell klonen

Navigieren Sie in das Plugins-Verzeichnis und klonen Sie das Repository:

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

Überprüfen Sie, ob das Verzeichnis existiert:

ls discourse-moetwemoji-twemoji-fakepng-override

3. Das Emoji-Override anwenden

Wechseln Sie zurück in das Discourse-Stammverzeichnis:

su - discourse
cd /var/www/discourse

Überprüfen Sie den aktuellen Status (optional, aber empfohlen):

RAILS_ENV=production bundle exec rake moetwemoji_twemoji:status

Wenden Sie das Override an:

RAILS_ENV=production bundle exec rake moetwemoji_twemoji:apply

Wenn der Befehl ohne Fehler abgeschlossen wird, wurden die Twemoji PNG-Dateien durch Moetwemoji ersetzt.

4. Wichtige Hinweise zu Neuaufbauten (Persistenz)

:red_exclamation_mark: Kein Neuaufbau erforderlich, damit das Override funktioniert

Diese Override-Version funktioniert, indem sie Dateien direkt im laufenden Container ersetzt.
Daher gilt:

  • :white_check_mark: Sie müssen NICHT ./launcher rebuild app ausführen

  • :white_check_mark: Änderungen werden unmittelbar nach Ausführung des Rake-Tasks wirksam

:warning: Aber die Änderung ist NICHT persistent

Da dies innerhalb des Container-Dateisystems geschieht:

  • Jeder zukünftige ./launcher rebuild app

  • Oder Container-Neuerstellung/-Upgrade

löscht die Änderungen, und das Emoji-Override geht verloren.

:backhand_index_pointing_right: Wenn Sie Persistenz über Neuaufbauten hinweg benötigen, müssen Sie das Plugin über app.yml-Hooks installieren und ordnungsgemäß neu aufbauen.

5. CDN- und Browser-Cache leeren (Sehr wichtig)

Nachdem das Override angewendet wurde, erscheinen Emojis möglicherweise aufgrund des Caching immer noch unverändert.

5.1 CDN-Cache leeren (z. B. Cloudflare)

Wenn Sie ein CDN wie Cloudflare verwenden:

  • Cache leeren für:

    • /images/emoji/*

    • Oder führen Sie bei Bedarf eine vollständige Cache-Löschung durch

Andernfalls werden möglicherweise weiterhin die alten Twemoji PNG-Dateien ausgeliefert.

5.2 Browser-Cache leeren

Auf der Client-Seite:

  • Seite hart neu laden (Strg + F5 / Cmd + Shift + R)

  • Oder Browser-Cache leeren

  • Oder in einem Inkognito-/Privatfenster testen

Solange sowohl der CDN- als auch der Browser-Cache nicht geleert wurden, sind die Emoji-Änderungen möglicherweise nicht sichtbar.

6. Zusammenfassung

  • Dieses Override-Plugin kann ohne Neuaufbau installiert und angewendet werden

  • Die manuelle Installation ist nützlich für:

    • Tests

    • Vorübergehende Nutzung

    • Debugging

  • Der Nachteil ist die fehlende Persistenz

  • Leeren Sie nach dem Anwenden von Emoji-Overrides immer den CDN-Cache + Browser-Cache