No description
  • JavaScript 66.8%
  • PHP 23.2%
  • CSS 10%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Lyra 971c7f25df Bump to 1.0.2
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-08 23:53:22 +02:00
js Label the toggle button instead of showing only the </> icon 2026-10-08 22:38:45 +02:00
php Treat gromox-generated HTML as no HTML version 2026-10-08 01:54:02 +02:00
resources/css Invert the button in dark mode like grommunio's own icons 2026-10-08 23:48:58 +02:00
config.php Add mail format toggle plugin for grommunio web 2026-10-08 01:40:52 +02:00
LICENSE Add mail format toggle plugin for grommunio web 2026-10-08 01:40:52 +02:00
manifest.xml Bump to 1.0.2 2026-10-08 23:53:22 +02:00
README.md README: keep the CSS table row short 2026-10-08 23:49:28 +02:00

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