- JavaScript 66.8%
- PHP 23.2%
- CSS 10%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| js | ||
| php | ||
| resources/css | ||
| config.php | ||
| LICENSE | ||
| manifest.xml | ||
| README.md | ||
grommunio-web-plugin-mailformattoggle
Plugin für grommunio web, das eine einzelne Mail per Knopfdruck zwischen Text- und HTML-Darstellung umschaltet. Die globale Einstellung Einstellungen → Mail → Eingehende Mails lesen als bleibt unverändert.
Was es macht
- Ein Knopf „HTML-Ansicht“ / „Text-Ansicht“ im Lesebereich und in der Werkzeugleiste geöffneter Mails.
- Steht die Mail als Text da, holt ein Klick die HTML-Fassung vom Server und zeigt sie an. Ein zweiter Klick schaltet zurück auf Text.
- Gilt nur für die gerade angezeigte Mail. Beim Wechsel zur nächsten Mail greift wieder die globale Einstellung.
- Die HTML-Fassung läuft durch dieselbe Bereinigung wie im Kern (DOMPurify,
Blockieren externer Inhalte, Inline-Bilder per
cid:). - Hat eine Mail keinen HTML-Teil, meldet das Plugin das, statt umzuschalten.
- Ausgenommen sind PGP-Mails: Deren entschlüsselter Inhalt existiert nur im Browser, der Server kann keine HTML-Fassung davon liefern.
Voraussetzungen
Geschrieben gegen grommunio web 5.1 (Namespace Grommunio.*). Ältere
Versionen mit Zarafa.*-Namespace werden nicht unterstützt.
Installation
Den Repo-Inhalt auf dem grommunio-Server nach
/usr/share/grommunio-web/plugins/mailformattoggle/ legen — der
Verzeichnisname muss mailformattoggle lauten —, danach in grommunio web ab-
und wieder anmelden. Ein bloßes Neuladen reicht nicht: Die Plugin-Liste wird
pro Sitzung zwischengespeichert.
Das Plugin ist für alle Benutzer eingeschaltet und lässt sich unter
Einstellungen → Plugins abschalten. Soll es standardmäßig aus sein, in
config.php PLUGIN_MAILFORMATTOGGLE_USER_DEFAULT_ENABLE auf false setzen.
Paket-Updates von grommunio web lassen das Verzeichnis unangetastet, da es keinem Paket gehört.
Aktualisieren
Dateien überschreiben und erneut ab- und anmelden. grommunio web hängt an
Plugin-Dateien nur die Version der Webapp an (?version=…), die sich bei
einem Plugin-Update nicht ändert. Browser und ein vorgeschalteter
Reverse-Proxy mit Asset-Cache (z. B. Nginx Proxy Manager mit „Cache
Assets“) liefern deshalb weiter den alten Stand. Im Browser hilft ein
Hard-Reload, auf dem Proxy muss der Cache-Eintrag für
/web/plugins/mailformattoggle/… gelöscht werden.
Aufbau
| Datei | Zweck |
|---|---|
manifest.xml |
Plugin-Beschreibung für den Plugin-Manager |
config.php |
Standard: für alle Benutzer an |
php/plugin.mailformattoggle.php |
trägt den Standardwert in die Settings ein |
php/class.pluginmailformattogglemodule.php |
liefert den HTML-Body einer Mail |
js/MailFormatTogglePlugin.js |
Knopf und Umschaltlogik im Client |
resources/css/mailformattoggle.css |
Icon, Dark Mode per Invert-Filter |
Der Kern liefert den HTML-Body nicht aus, solange die Mail-Einstellung auf
Text steht (grommunio/v1/contexts/mail/use_html_email_preview). Das
Server-Modul öffnet deshalb die Mail selbst und gibt nur den HTML-Body zurück.
Der Client legt ihn in den Datensatz der angezeigten Mail; das Rendern
übernimmt die normale Nachrichtenansicht.
Lizenz
MIT — Lyra, DravenTec