Mail Log

• Mail Log im Überblick
• Voraussetzungen und Installation
• Download-Schlüssel und Updates
• Schnellstart: das Dashboard
• Die Log-Liste
• Einen Eintrag ansehen
• Eine Mail erneut senden
• Body-Speicherung, Verschlüsselung und sensible Inhalte
• Anhänge
• Log-Regeln und Anzeigeregeln
• Benachrichtigungen bei Fehlern
• Konfigurationsreferenz
• Wartung: geplante Aufgaben
• Rechte, Export und Datenschutz
• Häufige Fragen und Fehlerbehebung
• Änderungsprotokoll

Mail Log im Überblick

Mail Log protokolliert jede E-Mail, die Ihre Joomla-Website über den Joomla-Mailer versendet. Zu jeder Nachricht sehen Sie, wer sie ausgelöst hat, an wen sie ging, ob die Zustellung gelang und — je nach Einstellung — den vollständigen Inhalt. Fehlgeschlagene Zustellungen werden ebenso festgehalten wie erfolgreiche. So haben Sie einen lückenlosen Nachweis darüber, was Ihre Website tatsächlich verschickt.

Mail Log ist eine reine Administrator-Erweiterung für Joomla 6 und erzeugt keinerlei Ausgabe im Frontend.

Wofür Sie Mail Log einsetzen

• Fehlersuche bei der Zustellung. Sie sehen sofort, welche Mails fehlgeschlagen sind, mit der genauen Fehlermeldung des Mailservers.
• Nachweis und Audit. Wurde die Bestellbestätigung, die Registrierungsmail, die Benachrichtigung wirklich versendet? Der Log beantwortet das mit Zeitstempel, Empfänger und Inhalt.
• Erneutes Senden. Eine verlorene Mail lässt sich mit einem Klick erneut zustellen — an die ursprünglichen oder an eine andere Adresse.
• Überblick über das Aufkommen. Das Dashboard zeigt Volumen, Spitzenzeiten und Fehlerraten auf einen Blick.

Datenschutz ist eingebaut, nicht angeflanscht

Ein Mail-Log speichert naturgemäß potenziell sensible Inhalte. Mail Log geht deshalb ab Werk sparsam mit den Daten um:

• Sensible Mails werden erkannt. Nachrichten mit Betreffzeilen wie „Passwort zurücksetzen", „Token" oder „2FA" werden automatisch als sensibel eingestuft und standardmäßig nur mit Metadaten gespeichert — der Reset-Link landet nicht im Log.
• Verschlüsselung ohne Schlüssel in der Datenbank. Wählen Sie die verschlüsselte Speicherung, wird der Schlüssel aus dem geheimen Joomla-Schlüssel abgeleitet und liegt nicht in der Datenbank. Ein Datenbank-Diebstahl allein gibt die Inhalte nicht preis.
• Anhänge außerhalb des Web-Roots. Erfasste Anhänge werden in ein geschütztes Verzeichnis kopiert, das nicht direkt über das Web erreichbar ist.
• Getrennte Rechte fürs Lesen. Wer die Liste sehen darf, darf nicht automatisch auch die Nachrichtentexte lesen — das ist ein eigenes Recht.
• Strikt lokal. Es werden keine externen Dienste kontaktiert. Keine Daten verlassen Ihre Website.

Woraus Mail Log besteht

Das Paket installiert drei zusammengehörige Erweiterungen:

• Die Komponente com_maillog — die Oberfläche im Backend mit Dashboard, Liste und Detailansicht.
• Das System-Plugin plg_system_maillog — es fängt den Mailversand ab und schreibt die Log-Einträge. Ohne dieses Plugin wird nichts protokolliert.
• Das Task-Plugin plg_task_maillog — die Wartungsaufgaben für den Joomla-Aufgabenplaner (Aufräumen, Statistik, Migration).

Wie Sie weiterlesen

Wenn Sie neu einsteigen, folgen Sie am besten dieser Reihenfolge:

1. Voraussetzungen und Installation
2. Download-Schlüssel und Updates
3. Schnellstart: das Dashboard
4. Die Log-Liste
5. Einen Eintrag ansehen
6. Body-Speicherung, Verschlüsselung und sensible Inhalte

Gilt für Version 1.0.4.

Voraussetzungen und Installation

Mail Log wird als ein Paket installiert, das die Komponente und die beiden Plugins zusammen einspielt. Diese Seite nennt die Voraussetzungen und beschreibt, was nach der Installation aktiv ist.

Voraussetzungen

Joomla	6.0 oder neuer
PHP	8.3 oder neuer
Datenbank	MySQL 8.0.13+ oder MariaDB 10.4+
PHP-Erweiterung	sodium (für die optionale Verschlüsselung; in PHP 8.3 standardmäßig vorhanden)

Installation

1. Laden Sie das Paket pkg_maillog-<version>.zip herunter.
2. Öffnen Sie im Backend System → Installieren → Erweiterungen und ziehen Sie die ZIP-Datei in den Bereich Paketdatei hochladen.
3. Nach dem Hochladen ist Mail Log installiert. Sie finden es im Menü unter Komponenten → Mail Log.

Was nach der Installation aktiv ist

Damit Mail Log sofort protokolliert, aktiviert die Installation das System-Plugin automatisch. Ab diesem Moment wird jede versendete Mail erfasst — Sie müssen nichts weiter einschalten.

Das Task-Plugin wird ebenfalls aktiviert, führt aber von allein nichts aus. Seine Wartungsaufgaben laufen erst, wenn Sie sie im Joomla-Aufgabenplaner einrichten (siehe das Kapitel Wartung: geplante Aufgaben).

Erste Kontrolle

Um zu prüfen, dass alles läuft, senden Sie eine Test-E-Mail über System → Konfiguration → Server → Test-E-Mail senden. Öffnen Sie anschließend Komponenten → Mail Log: Die Testnachricht sollte als jüngster Eintrag in der Liste erscheinen.

Was in der Datenbank angelegt wird

Die Installation legt vier Tabellen an (Einträge, Empfänger, Tagesstatistik und eine kleine Tabelle zur Drosselung der Benachrichtigungen). Bei einer Deinstallation werden diese Tabellen und ihre Daten wieder entfernt. Erfasste Anhang-Dateien im geschützten Verzeichnis bleiben dagegen erhalten, damit ein versehentliches Deinstallieren keine Beweismittel vernichtet — löschen Sie diesen Ordner bei Bedarf von Hand.

Gilt für Version 1.0.4.

Download-Schlüssel und Updates

Mail Log erhält Updates über den offiziellen Joomla-Update-Mechanismus. Damit Ihre Website die Aktualisierungen abrufen darf, tragen Sie einmalig Ihren persönlichen Download-Schlüssel ein.

Den Download-Schlüssel eintragen

1. Erzeugen Sie Ihren Download-Schlüssel in Ihrem Kundenkonto auf graup-it.de (Menüpunkt Download-IDs). Ein Schlüssel gilt pro Website und deckt alle darüber bezogenen Erweiterungen ab.
2. Öffnen Sie im Backend System → Aktualisieren → Update-Quellen.
3. Öffnen Sie den Eintrag Mail Log Update Site und tragen Sie den Schlüssel in das Feld Download-Schlüssel ein.
4. Speichern.

Updates einspielen

1. Öffnen Sie System → Aktualisieren → Erweiterungen aktualisieren.
2. Ist eine neue Version verfügbar, erscheint Mail Log in der Liste. Wählen Sie es aus und klicken Sie auf Aktualisieren.
3. Joomla lädt das Paket über Ihren Download-Schlüssel, prüft die Prüfsumme und spielt die neue Version ein.

Findet Joomla kein Update, obwohl eine neue Version vorliegt, klicken Sie zunächst auf Auf Updates prüfen, um den Zwischenspeicher zu aktualisieren.

Manueller Weg

Sie können jede Version auch manuell installieren: das ZIP herunterladen und wie bei der Erstinstallation über System → Installieren → Erweiterungen einspielen. Ein Update über das Paket überschreibt die vorhandene Installation und erhält Ihre Einstellungen und Log-Daten.

Gilt für Version 1.0.4.

Schnellstart: das Dashboard

Nach der Installation läuft Mail Log sofort. Diese Seite zeigt, wie Sie den ersten Eintrag erzeugen und das Dashboard richtig lesen.

Den ersten Eintrag erzeugen

Senden Sie eine beliebige E-Mail über Ihre Website — am einfachsten die eingebaute Test-E-Mail unter System → Konfiguration → Server → Test-E-Mail senden. Öffnen Sie danach Komponenten → Mail Log. Die Nachricht erscheint als jüngster Eintrag.

Das Dashboard lesen

Oben stehen vier Kennzahlen:

Kachel	Bedeutung
E-Mails gesamt	Alle protokollierten Mails, aufgeschlüsselt in gesendet und fehlgeschlagen.
Heute	Mails des laufenden Tages mit Fehlerrate.
Letzte 7 Tage	Wochenwert mit Fehlerrate.
Letzte 30 Tage	Monatswert mit Fehlerrate.

Darunter folgen:

• Das Aktivitätsdiagramm — gesendete und fehlgeschlagene Mails pro Tag, gestapelt. Über dem Diagramm steht die Spitzenstunde des Zeitraums.
• Letzte E-Mails — die jüngsten Nachrichten mit Status, Betreff und Absender. Ein Klick öffnet die Detailansicht.
• Letzte Fehler — die jüngsten fehlgeschlagenen Zustellungen, damit Sie Probleme sofort sehen.

Von hier aus weiter

Über die Schaltfläche Logs öffnen gelangen Sie zur vollständigen Liste. Dort filtern und durchsuchen Sie alle Einträge — das beschreibt das Kapitel Die Log-Liste.

Gilt für Version 1.0.4.

Die Log-Liste

Die Log-Liste zeigt alle protokollierten Mails. Sie erreichen sie über den Menüpunkt Mail Log in der Seitenleiste oder über Logs öffnen im Dashboard.

Die Spalten

Spalte	Inhalt
Status	Gesendet, Fehlgeschlagen oder Übersprungen. Bei Fehlern zeigt ein Tooltip die Fehlermeldung.
Zeit	Zeitpunkt des Versands.
Absender	Die Absenderadresse.
Empfänger	Der erste Empfänger; weitere werden als „+n" angezeigt.
Betreff	Die Betreffzeile. Symbole weisen auf Anhänge und auf erneut gesendete Mails hin.
Quelle	Die Erweiterung, die den Versand ausgelöst hat, sofern erkannt (z. B. com_users).
Aktionen	Eintrag ansehen und — mit entsprechendem Recht — erneut senden.

Ein gelbes Demo-Kennzeichen markiert Testeinträge, die Sie selbst erzeugt haben (siehe unten).

Suchen und filtern

Über Filter-Optionen öffnen Sie die Filterleiste:

Suche	Durchsucht Betreff, Absender, Empfänger, Quelle und die Referenz-Kennung.
Status	Nur gesendete, nur fehlgeschlagene oder alle.
Zeitraum	Schnellauswahl (heute, 7/30/90 Tage) oder ein eigenes Von-/Bis-Datum.
Absender enthält / Empfänger enthält	Freitext-Teiltreffer auf die Adressen.
Quell-Erweiterung	Auf eine bestimmte auslösende Erweiterung einschränken.
Kontext	Frontend, Backend, CLI oder API — je nachdem, wo die Mail entstand.

Die Spaltenköpfe Status, Zeit, Absender, Betreff und Quelle sind sortierbar. Die Seitengröße stellen Sie im Fuß der Liste ein.

Mehrere Einträge auf einmal

Über die Auswahlkästchen markieren Sie mehrere Einträge und wenden dann eine Aktion der Werkzeugleiste an — Erneut senden oder Löschen (jeweils passendes Recht vorausgesetzt). Beide Aktionen fragen vorher nach.

Exportieren

Die Schaltfläche CSV exportieren gibt die aktuell gefilterte Liste als CSV-Datei aus — vollständig, nicht nur die angezeigte Seite. Der Body-Inhalt ist im Export bewusst nicht enthalten; Details siehe Rechte, Export und Datenschutz.

Demo-Daten zum Ausprobieren

Mit dem Recht Demo-Daten verwalten erzeugen Sie über die Werkzeugleiste realistisch aussehende Testeinträge, um Liste, Dashboard und Detailansicht auszuprobieren. Alle Demo-Einträge tragen das Demo-Kennzeichen und lassen sich mit einem Klick wieder entfernen.

Gilt für Version 1.0.4.

Einen Eintrag ansehen

Ein Klick auf einen Eintrag — auf die Zeit, den Betreff oder die Ansehen-Schaltfläche — öffnet die Detailansicht mit allen erfassten Angaben zu dieser Mail.

Die Metadaten

Die linke Spalte fasst zusammen, was über die Mail bekannt ist:

• Status, Zeitpunkt und eine eindeutige Referenz-Kennung
• Absender sowie An, CC, BCC und Antwort an
• Quelle (auslösende Erweiterung) und Kontext (Frontend/Backend/CLI/API)
• die IP-Adresse und der angemeldete Benutzer, sofern vorhanden
• bei Fehlern die vollständige Fehlermeldung des Mailservers
• ein Hinweis, falls der Text gekürzt gespeichert wurde

Die Inhalts-Reiter

Reiter	Inhalt
HTML	Der HTML-Text, in einer abgeschotteten Vorschau dargestellt (dazu unten mehr).
Text	Die reine Textfassung der Nachricht.
Header	Die benutzerdefinierten Kopfzeilen der Nachricht.
Rohes MIME	Die exakte RFC822-Nachricht, sofern deren Speicherung aktiviert ist.
Anhänge (n)	Die erfassten Anhänge mit Name, Typ und Größe zum Herunterladen.

Wenn kein Text da ist

Je nach Einstellung ist der Body bewusst nicht oder nur teilweise gespeichert. In diesen Fällen erklärt ein Hinweis den Grund:

• „Der Body ist verschlüsselt gespeichert und wurde für die Anzeige entschlüsselt." — Sie sehen den Klartext, in der Datenbank liegt er verschlüsselt.
• „Für diesen Eintrag werden nur Metadaten gespeichert." — typisch für sensible Mails wie Passwort-Resets.
• „Für diesen Eintrag werden nur die ersten 4 KB des Body gespeichert." — die Voreinstellung speichert einen kurzen Auszug; die angezeigte Größe entspricht der konfigurierten Auszugsgröße.

Das Lesen der Bodies setzt das Recht Mail-Inhalt ansehen voraus. Fehlt es, sehen Sie die Metadaten, aber nicht den Text.

Herunterladen

Mit dem Recht Anhänge und .eml herunterladen laden Sie über die Werkzeugleiste die rohe Nachricht als .eml-Datei herunter (zum Öffnen in einem Mailprogramm) sowie einzelne Anhänge aus dem gleichnamigen Reiter.

Versand-Kette

Wurde eine Mail erneut gesendet, verknüpft Mail Log den neuen Eintrag mit dem ursprünglichen. Die Detailansicht zeigt diese Kette, sodass Sie nachvollziehen können, welcher Versand aus welchem hervorging.

Gilt für Version 1.0.4.

Eine Mail erneut senden

Mail Log kann eine protokollierte Nachricht erneut zustellen. Das ist nützlich, wenn eine Mail verloren ging, im Spam landete oder an die falsche Adresse ging. Der erneute Versand nutzt den gespeicherten Inhalt und läuft über den normalen Joomla-Mailer — es entsteht ein neuer Log-Eintrag.

So senden Sie erneut

• Aus der Liste: die Schaltfläche Erneut senden in der Aktionsspalte, oder mehrere Einträge markieren und die Werkzeugleisten-Aktion Erneut senden verwenden.
• Aus der Detailansicht: der Abschnitt Erneut senden mit der Schaltfläche Diese E-Mail erneut senden.

An eine andere Adresse

In der Detailansicht können Sie eine alternative Empfänger-Adresse eintragen. Ist sie gesetzt, geht die Mail nur an diese eine Adresse; die ursprünglichen Empfänger werden ignoriert. Bleibt das Feld leer, gehen Betreff, Text und Anhänge an die ursprünglichen Empfänger.

Wenn der erneute Versand nicht möglich ist

Damit nichts Unerwartetes passiert, verweigert Mail Log den erneuten Versand in einigen Fällen mit einer klaren Meldung:

• Nur Metadaten gespeichert. Wurde die Mail als sensibel eingestuft (z. B. ein Passwort-Reset) und nur mit Metadaten abgelegt, ist ihr Text nicht vorhanden und kann nicht erneut gesendet werden.
• Text nicht rekonstruierbar. Ist der Body verschlüsselt und der Schlüssel nicht verfügbar oder wurde er nur verkürzt gespeichert, meldet Mail Log dies statt eine leere Mail zu verschicken.

Schutz vor Missbrauch

Zwei Grenzen verhindern versehentliche Massenversände und Missbrauch:

• Zwischen zwei erneuten Versänden derselben Mail liegt eine Wartezeit von 30 Sekunden.
• Eine einzelne Mail lässt sich höchstens 20-mal erneut senden.

Beide Werte sind bewusst fest, damit ein kompromittiertes Konto Mail Log nicht als Spam-Schleuder missbrauchen kann.

Gilt für Version 1.0.4.

Body-Speicherung, Verschlüsselung und sensible Inhalte

Wie viel vom Nachrichtentext Mail Log speichert, entscheiden Sie selbst. Diese Seite erklärt die Speichermodi, die Verschlüsselung und die Sonderbehandlung sensibler Mails. Alle Einstellungen finden Sie in den Optionen unter den Reitern Body-Speicherung, Rohes MIME und Sensible Inhalte.

Die Speichermodi für den Body

Modus	Was gespeichert wird
Metadaten + erste N KB (Voreinstellung)	Nur die ersten Kilobytes des Texts. Reicht für einen Eindruck, ohne lange Nachrichten vollständig abzulegen. Die Größe stellen Sie mit Zu behaltende Body-Größe (KB) ein (Standard 4 KB).
Vollständiger Body	Der komplette Text im Klartext.
Vollständig, verschlüsselt	Der komplette Text, verschlüsselt in der Datenbank (siehe unten).
Vollständig, automatisches Löschen nach N Tagen	Der komplette Text, aber der Wartungs-Task entfernt ihn nach der eingestellten Frist wieder und behält nur die Metadaten.
Nur Metadaten	Gar kein Text — nur Absender, Empfänger, Betreff, Status und Zeit.

Zusätzlich begrenzt Maximale Body-Größe (KB) als globale Schutzobergrenze jeden Text; größere Bodies werden gekürzt und in der Detailansicht als gekürzt markiert.

Rohes MIME

Unabhängig vom Body-Modus können Sie im Reiter Rohes MIME die exakte, wie versendet aufgebaute RFC822-Nachricht speichern. Das ermöglicht saubere .eml-Downloads für ein Audit. Weil das rohe MIME den vollständigen Klartext enthält, ist diese Option ab Werk ausgeschaltet. Sie lässt sich ebenfalls verschlüsseln.

Verschlüsselung

Verschlüsselte Bodies und MIME-Nachrichten schützt Mail Log mit einem modernen Verfahren (AES-256-GCM bzw. XChaCha20-Poly1305). Entscheidend ist die Herkunft des Schlüssels:

Das Feld Verschlüsselungs-Key in den Optionen ist seit dieser Version eine reine Statusanzeige. Sie müssen nichts eintragen oder erzeugen. Zeigt es einen „Alt-Schlüssel", stammt er aus einer früheren Version; der Wartungs-Task Alt-verschlüsselte Bodies migrieren stellt solche Einträge auf das neue Verfahren um und entfernt den Alt-Schlüssel danach selbst.

Sensible Mails

Manche Mails sollten nie im Klartext im Log landen — Passwort-Resets, Bestätigungslinks, Einmal-Codes. Mail Log erkennt sie an der Betreffzeile und behandelt sie gesondert.

Im Reiter Sensible Inhalte stehen dafür zwei Musterlisten (je ein regulärer Ausdruck pro Zeile) und eine Richtlinie:

Betreff-Muster	Passt der Betreff auf eines der Muster, gilt die Mail als sensibel. Ab Werk sind Muster für password, passwort, reset, token, 2fa, verify und verifizier hinterlegt.
Behandlung sensibler Mails	Nur Metadaten (Voreinstellung, kein Body, keine Anhänge), Normal protokollieren oder Gar nicht protokollieren.
Body-Masking-Muster	Zusätzliche Muster, deren Treffer im gespeicherten Text durch *** ersetzt werden — etwa token=… oder key=….

Mit den Voreinstellungen landet ein Passwort-Reset-Link also nicht im Log, ohne dass Sie etwas einrichten müssten.

Gilt für Version 1.0.4.

Anhänge

Auf Wunsch sichert Mail Log die Anhänge versendeter Mails, damit Sie später nachvollziehen können, was genau verschickt wurde. Die Einstellungen dazu stehen in den Optionen im Reiter Anhänge.

Wie Anhänge erfasst werden

Ist Anhänge erfassen aktiv, kopiert Mail Log beim Versand jeden Anhang in ein geschütztes Verzeichnis und vermerkt ihn im Log-Eintrag. In der Detailansicht erscheinen die Anhänge im Reiter Anhänge mit Name, Typ und Größe und lassen sich einzeln herunterladen (Recht Anhänge und .eml herunterladen vorausgesetzt).

Wo Anhänge liegen — außerhalb des Web-Roots

Über Speicherpfad können Sie einen eigenen Ort festlegen. Bleibt das Feld leer, gilt der sichere Standardpfad. Zur zusätzlichen Absicherung legt Mail Log im Anhang-Verzeichnis Sperrdateien (.htaccess, web.config) ab.

Grenzen und Speicherbudget

Option	Standard	Bedeutung
Anhänge erfassen	Ja	Anhänge beim Versand auf die Festplatte kopieren.
Speicherpfad	leer (= sicherer Standard)	Ablageort der Anhänge.
Max. pro Datei (MB)	10	Größere Anhänge werden übersprungen; die Metadaten (Name, Typ, Größe) bleiben trotzdem im Log.
Gesamt-Speicherbudget (MB)	500	Ist das Budget erschöpft, werden neue Anhänge bis zum nächsten Aufräumen nicht mehr kopiert.

Aufräumen

Wie lange Anhang-Dateien aufbewahrt werden, steuert Anhang-Aufbewahrung (Tage) im Reiter Aufbewahrung (Standard 30 Tage). Der Wartungs-Task Anhang-Dateien bereinigen entfernt ältere Dateien und solche, deren Log-Eintrag bereits gelöscht wurde. Wie Sie diesen Task einrichten, steht im Kapitel Wartung: geplante Aufgaben.

Sicherheit der Dateinamen

Mail Log bereinigt jeden Anhang-Dateinamen vor dem Speichern und entschärft potenziell ausführbare Endungen (etwa .php), indem es .bin anhängt. Zusammen mit dem Speicherort außerhalb des Web-Roots ist damit ausgeschlossen, dass ein Anhang auf dem Server ausgeführt werden kann.

Gilt für Version 1.0.4.

Log-Regeln und Anzeigeregeln

Mail Log kennt zwei Arten von Regeln, die leicht zu verwechseln sind, aber sehr Unterschiedliches tun. Beide finden Sie in den Optionen.

Log-Regeln: was gar nicht erst gespeichert wird

Log-Regeln greifen vor dem Schreiben in die Datenbank. Damit halten Sie uninteressante Massen-Mails aus dem Log heraus — etwa laute Benachrichtigungen eines bestimmten Dienstes. Was eine Log-Regel ausschließt, entsteht gar nicht erst als Eintrag.

Zwei Einstellungen bestimmen das Verhalten:

Modus	Passende ausschließen — passende Mails werden NICHT protokolliert. Nur passende einschließen — NUR passende Mails werden protokolliert, alles andere wird verworfen.
Match	Ob eine Mail alle Regeln (UND) oder beliebige (ODER) erfüllen muss.

Anzeigeregeln: was in der Liste ausgeblendet wird

Anzeigeregeln wirken nach dem Speichern. Passende Einträge werden lediglich in Liste und Dashboard ausgeblendet — gelöscht wird nichts. Ändern Sie die Regel, erscheinen die Einträge wieder. Nützlich, um eine überladene Ansicht aufzuräumen, ohne Daten zu verlieren.

Wie eine Regel aufgebaut ist

Beide Regeltypen bestehen aus denselben Bausteinen. Jede Regel prüft ein Feld mit einem Operator gegen einen Wert:

Feld	Betreff, Body, Empfänger oder Absender.
Operator	enthält, enthält nicht, ist gleich, ist ungleich, beginnt mit, endet mit — bei Anzeigeregeln zusätzlich ist leer / ist nicht leer.
Wert	Der Vergleichstext.

Beispiele

• Cronjob-Mails nicht protokollieren: Log-Regel, Modus Passende ausschließen, Feld Absender, Operator enthält, Wert cron@.
• Nur Bestellmails protokollieren: Log-Regel, Modus Nur passende einschließen, Feld Betreff, Operator enthält, Wert Bestellung.
• Interne Test-Mails ausblenden: Anzeigeregel, Feld Empfänger, Operator endet mit, Wert @intern.example.

Gilt für Version 1.0.4.

Benachrichtigungen bei Fehlern

Mail Log kann Sie aktiv warnen, wenn eine Zustellung fehlschlägt — so erfahren Sie von einem Mailproblem, ohne ständig ins Log schauen zu müssen. Die Einstellungen stehen in den Optionen im Reiter Benachrichtigungen.

Aktivieren und Empfänger wählen

Option	Standard	Bedeutung
Benachrichtigungen aktivieren	Nein	Hauptschalter. Standardmäßig aus.
Super Admins benachrichtigen	Ja	An alle Super Users senden, die in ihrem Profil System-E-Mails empfangen aktiviert haben.
Zusätzliche Empfänger	leer	Weitere Adressen, eine pro Zeile oder durch Komma getrennt.
Zusätzlich als Joomla-Privatnachricht	Nein	Legt den Alert zusätzlich als interne Nachricht (com_messages) für jeden Super User ab.

Nicht zu viele Meldungen: die Drosselung

Damit ein reihenweises Fehlschlagen (etwa ein ausgefallener Mailserver) Sie nicht mit Hunderten Warnungen überflutet, fasst Mail Log Alerts zusammen.

Kein Kreislauf

Die Warn-Mail selbst wird beim Versand nicht wieder als neuer Fehler behandelt — Mail Log verhindert gezielt, dass eine Benachrichtigung eine weitere auslöst. So kann kein Alarm-Kreislauf entstehen.

Empfehlung

Für Produktivseiten lohnt es sich, Benachrichtigungen einzuschalten und mindestens die Super Admins als Empfänger zu behalten. So bemerken Sie einen Zustellausfall in Minuten statt erst bei der nächsten Kundenbeschwerde.

Gilt für Version 1.0.4.

Konfigurationsreferenz

Alle Einstellungen erreichen Sie über die Schaltfläche Optionen oben rechts in jeder Ansicht von Mail Log. Diese Seite listet jede Option mit ihrer Voreinstellung. Einige Bereiche sind in eigenen Kapiteln ausführlicher beschrieben; hier finden Sie den vollständigen Überblick.

Logging

Option	Standard	Bedeutung
Logging aktivieren	Ja	Hauptschalter. Aus = keine neuen Einträge; vorhandene bleiben zugänglich.
Fehlgeschlagene Mails protokollieren	Ja	Auch Mails erfassen, die der Mailer als nicht versendet meldet.
Kontexte protokollieren	Frontend, Backend, CLI, API	Wo protokolliert wird. Die vier Bereiche sind unabhängig wählbar.
Quell-Erweiterung erkennen	Ja	Ermittelt die auslösende Erweiterung (Best-Effort). Abschalten spart minimal Aufwand pro Mail.

Body-Speicherung

Option	Standard	Bedeutung
Speichermodus	Metadaten + erste N KB	Wie viel Text abgelegt wird (siehe Kapitel Body-Speicherung, Verschlüsselung und sensible Inhalte). Wirkt nur auf neue Einträge.
Body-Aufbewahrung (Tage)	30	Nur bei „Vollständig, automatisches Löschen": nach dieser Frist entfernt der Task den Text.
Zu behaltende Body-Größe (KB)	4	Nur bei „Metadaten + erste N KB": wie viele Kilobytes vom Anfang gespeichert werden.
Maximale Body-Größe (KB)	1024	Globale Obergrenze. Größere Bodies werden gekürzt und markiert.
Verschlüsselungs-Key	—	Reine Statusanzeige. Der Schlüssel wird aus dem geheimen Joomla-Schlüssel abgeleitet; nichts einzutragen.

Rohes MIME

Rohes MIME speichern	Nein	Die exakte RFC822-Nachricht ablegen (für saubere .eml-Downloads). Aus Datenschutzgründen ab Werk aus.
Rohes MIME verschlüsseln	Nein	Dieselbe Verschlüsselung wie für Bodies auf das MIME anwenden.

Anhänge

Anhänge erfassen	Ja	Jeden Anhang beim Versand auf die Festplatte kopieren.
Speicherpfad	leer (= sicherer Standard außerhalb des Web-Roots)	Ablageort der Anhänge.
Max. pro Datei (MB)	10	Größere Anhänge werden übersprungen; Metadaten bleiben.
Gesamt-Speicherbudget (MB)	500	Bei Überschreitung werden neue Anhänge bis zum nächsten Cleanup übersprungen.

Sensible Inhalte

Behandlung sensibler Mails	Nur Metadaten	Wie Mails behandelt werden, die auf die Betreff-Muster passen: nur Metadaten, normal oder gar nicht protokollieren.
Betreff-Muster	/password/i, /passwort/i, /reset/i, /token/i, /2fa/i, /verify/i, /verifizier/i	Ein regulärer Ausdruck pro Zeile. Passt der Betreff, gilt die Mail als sensibel.
Body-Masking-Muster	/token=…/, /key=…/	Treffer werden im gespeicherten Body durch *** ersetzt.

Aufbewahrung

Eintrag-Aufbewahrung (Tage)	180	Ältere Einträge entfernt der Task „Logs bereinigen". 0 = keine altersbasierte Bereinigung.
Maximale Eintragszahl	0 (aus)	FIFO-Obergrenze: älteste Einträge werden entfernt, sobald die Grenze überschritten ist.
Anhang-Aufbewahrung (Tage)	30	Ältere Anhang-Dateien entfernt der Anhang-Cleanup-Task.

Anzeigeregeln

Match	Alle (UND)	Ob eine Zeile alle oder beliebige Regeln erfüllen muss, um ausgeblendet zu werden.
Regeln	leer	Blenden passende Einträge aus Liste und Statistik aus, ohne sie zu löschen. Siehe Kapitel Log-Regeln und Anzeigeregeln.

Log-Regeln

Match	Beliebige (ODER)	Ob eine Mail alle oder beliebige Regeln treffen muss.
Modus	Passende ausschließen	Passende ausschließen oder nur passende einschließen.
Regeln	leer	Entscheiden vor dem Speichern, welche Mails überhaupt protokolliert werden.

Benachrichtigungen

Benachrichtigungen aktivieren	Nein	Warnen, wenn eine Zustellung fehlschlägt.
Super Admins benachrichtigen	Ja	An Super Users mit aktivierten System-E-Mails.
Zusätzliche Empfänger	leer	Weitere Adressen.
Throttle-Fenster (Minuten)	30	Mindestabstand zwischen zwei Alerts.
Zusätzlich als Joomla-Privatnachricht	Nein	Alert auch intern (com_messages) ablegen.

Dashboard

Statistik-Modus	Live	Live rechnet bei jedem Aufruf aus den Einträgen. Task nutzt vor-aggregierte Tageswerte, die der Statistik-Task pflegt — schneller bei sehr vielen Einträgen.
Standard-Zeitraum	Letzte 30 Tage	Voreingestellter Zeitraum des Diagramms.
Letzte Mails anzeigen	10	Wie viele Einträge die Dashboard-Listen zeigen.

Rechte

Der Standard-Reiter von Joomla. Welche Aktion welches Recht braucht, steht im Kapitel Rechte, Export und Datenschutz.

Gilt für Version 1.0.4.

Wartung: geplante Aufgaben

Mail Log bringt Wartungsaufgaben mit, die über den Joomla-Aufgabenplaner laufen. Sie halten die Datenbank schlank, pflegen die Statistik und erledigen einmalige Umstellungen. Von allein läuft keine dieser Aufgaben — Sie richten sie im Aufgabenplaner ein.

Eine Aufgabe einrichten

1. Öffnen Sie System → Verwalten → Geplante Aufgaben und klicken Sie auf Neu.
2. Wählen Sie im Auswahldialog einen der Mail-Log-Aufgabentypen (siehe Tabelle).
3. Vergeben Sie einen Namen, stellen Sie unter Ausführungsregeln das Intervall ein (z. B. täglich) und speichern Sie.
4. Aktivieren Sie die Aufgabe. Damit geplante Aufgaben tatsächlich laufen, muss der Joomla-Scheduler ausgelöst werden — per Website-Besuch (Standard) oder per echtem Cronjob.

Die Aufgabentypen

Aufgabe	Zweck
Alte Log-Einträge bereinigen	Löscht Einträge, die älter als die eingestellte Aufbewahrung sind, und erzwingt die maximale Eintragszahl (FIFO). Gebatcht, damit auch große Tabellen schonend abgearbeitet werden.
Anhang-Dateien bereinigen	Entfernt verwaiste Anhang-Dateien (deren Eintrag gelöscht wurde) und Dateien, die älter als die Anhang-Aufbewahrung sind.
Tagesstatistiken aktualisieren	Pflegt die vor-aggregierten Tageswerte für das Dashboard. Nur nötig, wenn Sie den Statistik-Modus auf Task gestellt haben.
Alte Mail-Bodies bereinigen	Setzt bei alten Einträgen den Text zurück und behält nur die Metadaten. Nur wirksam beim Speichermodus „Vollständig, automatisches Löschen nach N Tagen".
Alt-verschlüsselte Bodies migrieren	Einmalige Umstellung: schlüsselt Einträge aus einer früheren Version auf das aktuelle Verfahren um und entfernt den alten Schlüssel, sobald nichts mehr davon abhängt. So oft ausführen, bis keine Alt-Einträge mehr gemeldet werden.
Anhang-Dateien umziehen	Einmalige Umstellung: verschiebt Anhänge aus einem alten Speicherort (innerhalb des Web-Roots) an den sicheren Standardort. So oft ausführen, bis keine Dateien mehr übrig sind.

Empfehlung für den Regelbetrieb

Für die meisten Websites genügen zwei täglich laufende Aufgaben:

• Alte Log-Einträge bereinigen — hält die Tabelle im Rahmen.
• Anhang-Dateien bereinigen — nur nötig, wenn Sie Anhänge erfassen.

Die beiden Migrations-Aufgaben (Alt-verschlüsselte Bodies migrieren, Anhang-Dateien umziehen) brauchen Sie nur, wenn Sie von einer sehr frühen Version aktualisiert haben. Nach erledigter Migration können Sie sie deaktivieren oder löschen. Tagesstatistiken aktualisieren und Alte Mail-Bodies bereinigen sind nur bei den passenden Einstellungen sinnvoll.

Gilt für Version 1.0.4.

Rechte, Export und Datenschutz

Mail Log speichert potenziell sensible Kommunikationsdaten. Diese Seite fasst zusammen, wer was darf, was exportiert wird und welche Daten überhaupt gespeichert werden.

Berechtigungen

Die Rechte vergeben Sie wie bei jeder Joomla-Komponente unter Optionen → Rechte je Benutzergruppe. Mail Log trennt bewusst zwischen Ansehen und Lesen der Inhalte:

Recht	Erlaubt
Mail Log ansehen	Dashboard und Liste öffnen — die Metadaten, aber nicht zwingend die Nachrichtentexte.
Mail-Inhalt ansehen	Die vollständigen Bodies (HTML, Text, MIME) lesen. Getrennt vergeben, weil Bodies sensible Daten enthalten können.
Anhänge und .eml herunterladen	Angehängte Dateien und die rohe Nachricht herunterladen.
Mails erneut senden	Protokollierte Mails erneut zustellen.
Einträge löschen	Log-Einträge entfernen.
Demo-Daten verwalten	Testeinträge erzeugen und löschen.

Empfehlung: Vergeben Sie Mail-Inhalt ansehen und Anhänge und .eml herunterladen sparsam — idealerweise nur an die Personen, die tatsächlich Zustellprobleme untersuchen.

Export

Die Schaltfläche CSV exportieren in der Liste gibt die aktuell gefilterte Auswahl als CSV-Datei aus. Der Export enthält Kennung, Zeit, Status, Absender, Empfänger, Betreff, Quelle, Kontext und die Fehlermeldung — nicht jedoch den Nachrichtentext. Wer Bodies braucht, öffnet den Eintrag oder lädt die .eml-Datei herunter (mit den entsprechenden Rechten).

Welche Daten gespeichert werden

Pro Mail speichert Mail Log Absender und Empfänger, Betreff, Zeit und Status, den Kontext sowie — sofern vorhanden — die IP-Adresse und die Benutzer-Kennung des Auslösers. Wie viel vom Text abgelegt wird, bestimmen Sie über den Speichermodus; ab Werk ist das nur ein kurzer Auszug, und sensible Mails werden nur mit Metadaten gespeichert.

Datenschutz-Hinweise für den Betrieb

• Aufbewahrung begrenzen. Setzen Sie eine Eintrags-Aufbewahrung (Standard 180 Tage) und richten Sie die Bereinigungsaufgabe ein, damit alte Daten nicht unbegrenzt liegen bleiben.
• Sparsam speichern. Für die meisten Zwecke reicht der Standard „Metadaten + Auszug". Vollständige oder rohe Speicherung nur, wenn Sie sie wirklich brauchen.
• Verschlüsseln, wenn Sie Bodies vollständig behalten. Die verschlüsselte Speicherung hält den Schlüssel außerhalb der Datenbank.
• Rechte eng fassen. Trennen Sie das Lesen der Inhalte vom bloßen Ansehen der Liste.
• Auskunft und Löschung. Für Betroffenenanfragen filtern Sie die Liste nach der Adresse und exportieren oder löschen gezielt.

Alle Daten bleiben auf Ihrem Server — Mail Log kontaktiert keine externen Dienste.

Gilt für Version 1.0.4.

Häufige Fragen und Fehlerbehebung

Antworten auf häufige Fragen und die schnellsten Wege zur Fehlerbehebung.

Es werden gar keine Mails protokolliert

• Prüfen Sie, ob das System-Plugin plg_system_maillog aktiviert ist (System → Plugins). Ohne dieses Plugin wird nichts erfasst.
• Steht in den Optionen Logging aktivieren auf Ja?
• Ist der Kontext ausgewählt, in dem die Mail entsteht? Eine Mail aus einem Cron-Aufruf wird nur erfasst, wenn CLI aktiviert ist.
• Schließen Log-Regeln die Mail aus? Prüfen Sie besonders den Modus Nur passende einschließen.

Ich sehe die Liste, aber keine Nachrichtentexte

Zum Lesen der Bodies brauchen Sie das Recht Mail-Inhalt ansehen — es ist bewusst vom bloßen Ansehen getrennt. Lassen Sie es Ihrer Gruppe unter Optionen → Rechte zuweisen.

Ein Eintrag zeigt „Nur Metadaten" statt Text

Das ist meist Absicht: Die Mail wurde als sensibel eingestuft (z. B. ein Passwort-Reset) und deshalb ohne Body gespeichert. Alternativ speichert der Standardmodus nur einen kurzen Auszug. Beides steuern Sie in den Optionen unter Body-Speicherung und Sensible Inhalte — Änderungen wirken auf neue Einträge.

„Erneut senden" ist nicht möglich

Wurde die Mail nur mit Metadaten oder verkürzt gespeichert, fehlt der vollständige Text und die Mail kann nicht rekonstruiert werden. Bei verschlüsselten Bodies muss der geheime Joomla-Schlüssel unverändert sein. Kam die Meldung zu einer Wartezeit: Zwischen zwei Versänden derselben Mail liegen 30 Sekunden, und maximal 20 Wiederholungen sind möglich.

Das Update wird nicht gefunden oder schlägt fehl

• Klicken Sie zuerst auf Auf Updates prüfen, um den Zwischenspeicher zu aktualisieren.
• Ist der Download-Schlüssel bei der Update-Quelle eingetragen — und ohne Leerzeichen am Anfang oder Ende? Ein mitkopiertes Leerzeichen führt zu „Paketdownload fehlgeschlagen".
• Notfalls die neue Version manuell herunterladen und über System → Installieren einspielen.

Verschlüsselte Einträge sind plötzlich unlesbar

Der Schlüssel wird aus dem geheimen Joomla-Schlüssel (in configuration.php) abgeleitet. Wurde dieser geändert, lassen sich zuvor verschlüsselte Bodies nicht mehr entschlüsseln. Der geheime Schlüssel sollte nur bewusst und mit Bedacht gewechselt werden.

Die Datenbank wächst stark

Richten Sie die Aufgabe Alte Log-Einträge bereinigen ein und setzen Sie eine Eintrags-Aufbewahrung (Standard 180 Tage) oder eine maximale Eintragszahl. Speichern Sie außerdem nur so viel Body, wie Sie wirklich brauchen — der Standard „Metadaten + Auszug" ist schon sparsam.

Wo liegen die Anhänge?

Ab Werk außerhalb des öffentlich erreichbaren Bereichs, im Joomla-Log-Verzeichnis unter com_maillog/attachments. Sie sind nur über die Komponente mit Rechteprüfung erreichbar, nicht per direkter URL.

Was passiert beim Deinstallieren?

Die vier Datenbanktabellen mit allen Log-Daten werden entfernt. Bereits erfasste Anhang-Dateien bleiben im geschützten Verzeichnis liegen, damit ein versehentliches Deinstallieren keine Beweismittel vernichtet — löschen Sie diesen Ordner bei Bedarf von Hand.

Gilt für Version 1.0.4.

Änderungsprotokoll

Dieses Änderungsprotokoll listet alle veröffentlichten Versionen von Mail Log, die neueste zuerst.

Version 1.0.4 – 12.08.2026

Geändert

• Die Installationsangaben der drei Bestandteile wurden von wirkungslosen Einträgen befreit, damit das Paket die Prüfung des Joomla! Extensions Directory besteht.

Behoben

• Eine englische Meldung der Übersicht endete mit einem überflüssigen Leerzeichen.

Version 1.0.3 – 01.08.2026

Geändert

• Das Paket und seine drei Bestandteile tragen im Erweiterungs-Manager jetzt sprechende Namen; bisher standen dort technische Kürzel.

Version 1.0.2 – 31.07.2026

Hinzugefügt

• E-Mails aus Kommandozeilen- und Scheduler-Läufen werden protokolliert; bisher wurde dort nichts erfasst.
• Die Option „Protokollierte Kontexte“ wirkt jetzt tatsächlich. Ohne Auswahl wird weiterhin jeder Kontext protokolliert.
• Die Liste weist auf Einträge aus früheren Versionen hin, die keinen Nachrichtentext enthalten können, und verlinkt sie zum Löschen.

Geändert

• Der Download der rohen Nachricht verlangt jetzt zusätzlich die Berechtigung „Nachrichtentext ansehen“. Gruppen ohne sie verlieren den Download; Super-User sind nicht betroffen.
• Neuinstallationen protokollieren ab Werk vollständig: kompletter Nachrichtentext, Roh-Nachricht und auch Mails mit sensiblem Betreff. Bestehende Installationen behalten ihre Einstellungen.

Behoben

• Der Nachrichtentext protokollierter E-Mails blieb immer leer. Er wird jetzt wieder erfasst, ebenso Anhänge, Antwort-an, Kopfzeilen und die Fehlermeldung fehlgeschlagener Sendungen.
• Der erneute Versand aus dem Protokoll funktioniert wieder — ohne gespeicherten Nachrichtentext war er nicht möglich.
• Bei verschlüsselter Speicherung griffen die Maskierungsmuster für sensible Inhalte nie. Maskiert wird jetzt vor dem Verschlüsseln.
• Auf frischen Installationen wurde nichts maskiert, obwohl die Optionen zwei Maskierungsmuster als aktiv anzeigten.
• Die Erkennung von HTML-Nachrichten berücksichtigt jetzt auch mehrteilige Nachrichten und einen gesetzten Alternativtext.
• Bei gekürzt gespeichertem Nachrichtentext zeigte die Detailansicht die Originalgröße nicht an.
• Beim Speichern der Optionen wurden Anhänge aus Versionen vor 0.1.0 unzugänglich, weil ihr Ablageort verloren ging.
• Der Optionen-Button erschien auch für Gruppen ohne die nötige Berechtigung und wies beim Klick ab.

Version 1.0.1 – 31.07.2026

Hinzugefügt

• Nach Installation und Update erscheint ein Übersichtsfenster mit Version, Status und Einstiegen zu Erste Schritte, Download-Schlüssel und Handbuch.
• Ein Klick auf „Updates aktivieren“ führt direkt zu den Update-Quellen, bereits auf fehlende Download-Schlüssel gefiltert.
• Der Erweiterungs-Manager zeigt hinter der Versionsnummer die Liste der Änderungen.

Sprache

• Die Meldungen bei Installation und Update liegen in Deutsch und Englisch vor.

Version 1.0.0 – 20.07.2026

Geändert

• Das Symbol der Erweiterung zeigt jetzt die Mail-Log-Marke.

Behoben

• Der Haupteintrag im Administrationsmenü zeigte kein Symbol.

Hinweise

• Erstes stabiles Release. Funktionsstand von 0.1.2, gehärtet durch das Audit der 0.1.x-Reihe.

Version 0.1.2 – 20.07.2026

Behoben

• Scheduler-Aufgaben zeigten im Auswahldialog rohe Textbausteine statt Titel und Beschreibung.
• Der Hinweis auf die gekürzte Speicherung nannte einen Platzhalter statt der eingestellten Größe.
• Eine veraltete Beschreibung des Verschlüsselungsfelds in den Optionen wurde entfernt.

Version 0.1.1 – 17.07.2026

Behoben

• Version 0.1.0 hätte nie Updates gefunden: Die Update-Adresse war falsch und der Download-Schlüssel wurde nicht übergeben.

Version 0.1.0 – 17.07.2026

Sicherheit

• Der CSV-Export ist gegen eingeschleuste Tabellenformeln gehärtet.
• Der Schlüssel für die Verschlüsselung liegt nicht mehr in der Datenbank. Alt-verschlüsselte Einträge bleiben lesbar und werden von einer Aufgabe umgeschlüsselt.
• Anhänge liegen jetzt außerhalb des Web-Verzeichnisses. Bestehende Dateien bleiben erreichbar; eine Aufgabe verschiebt sie.
• Datenschutz ab Werk: Vom Nachrichtentext wird nur noch ein Auszug gespeichert, die Roh-Nachricht gar nicht, und Passwort-Mails landen nicht mehr im Klartext.
• Eine fehlgeschlagene Protokollierung wird jetzt gemeldet statt still übergangen.

Geändert

• Listen, Dashboard und Statistik sind spürbar schneller.

Behoben

• „Erneut senden“ und „Demo-Daten löschen“ funktionieren wieder.
• Der CSV-Export enthält alle gefilterten Einträge statt nur der ersten Seite und ist speicherschonend.
• Das Sendelimit beim erneuten Senden greift jetzt zuverlässig.
• Die Statistik-Aufgabe erzeugte überflüssige Doppeleinträge.

Sprache

• Alle Meldungen liegen in Deutsch und Englisch vor.

Hinweise

• Nach dem Update die Aufgaben zum Umschlüsseln und zum Verschieben der Anhänge einmalig ausführen, bis keine Restbestände mehr gemeldet werden.
• Wird das Sicherheitsgeheimnis von Joomla gewechselt, sind verschlüsselte Einträge nicht mehr lesbar.

Version 0.0.24 – 20.04.2026

Hinweise

• Letzter Stand vor der Sanierung.