Configuration reference
WirdAll synchronisiertsettings are reached through the Options button at the top right of every Mail
Log view. This page lists every option with its default. Some areas are described in more detail in
chapters of their own; here you find the complete overview.
The defaults are deliberately frugal with data and suitable for most websites. Especially in the
areas body storage and sensitive content, change only what you have
understood.
Logging
OptionDefaultMeaning
Enable loggingYesMain switch. Off = no new entries; existing ones stay accessible.
Log failed mailsYesAlso record mails the mailer reports as not sent.
Log contextsFrontend, backend, CLI, APIWhere logging happens. The four areas can be chosen independently.
Detect source extensionYesDetermines the triggering extension (best effort). Switching it off saves a minimal amount of work per mail.
Body storage
OptionDefaultMeaning
Storage modeMetadata + first N KBHow much text is kept (see the chapter Body storage, encryption and sensitive content). Affects new entries only.
Body retention (days)30Only with "full, deleted automatically": after this period the task removes the text.
Body size to keep (KB)4Only with "metadata + first N KB": how many kilobytes from the start are stored.
Maximum body size (KB)1024Global ceiling. Larger bodies are truncated and marked.
Encryption key—Purely a status display. The key is derived from the Joomla secret; there is nothing to enter.
Raw MIME
Store raw MIMENoKeep the exact RFC822 message (for clean .eml downloads). Off out of the box for privacy reasons.
Encrypt raw MIMENoApply the same encryption as for bodies to the MIME message.
Attachments
Capture attachmentsYesCopy every attachment to disk while sending.
Storage pathempty (= safe default outside the web root)Where the attachments are kept.
Max. per file (MB)10Larger attachments are skipped; the metadata remains.
Total storage budget (MB)500When exceeded, new attachments are skipped until the next cleanup.
Sensitive content
Handling of sensitive mailsMetadata onlyHow mails matching the subject patterns are treated: metadata only, normally, or not logged at all.
Subject patterns/password/i, /passwort/i, /reset/i, /token/i, /2fa/i, /verify/i, /verifizier/iOne regular expression per line. If the subject matches, the mail counts as sensitive.
Body masking patterns/token=…/, /key=…/Matches are replaced by *** in the stored body.
Retention
Entry retention (days)180Older entries are removed by the task "clean up logs". 0 = no age-based cleanup.
Maximum number of entries0 (off)FIFO ceiling: the oldest entries are removed as soon as the limit is exceeded.
Attachment retention (days)30Older attachment files are removed by the attachment cleanup task.
Display rules
MatchAll (AND)Whether a row has to satisfy all or any of the rules to be hidden.
RulesemptyHide matching entries from the list and the statistics without deleting them. See the chapter Log rules and display rules.
Log rules
MatchAny (OR)Whether a mail has to match all or any of the rules.
ModeExclude matchesExclude matches, or include matches only.
RulesemptyDecide before storing which mails are logged at all.
Notifications
Enable notificationsNoWarn when a delivery fails.
Notify super adminsYesTo super users with system emails enabled.
Additional recipientsemptyFurther addresses.
Throttle window (minutes)30Minimum gap between two alerts.
Also as a Joomla private messageNoFile the alert internally (com_messages) as well.
Dashboard
Statistics modeLiveLive calculates from the entries on every view. Task uses pre-aggregated daily figures maintained by the statistics task — faster with very many entries.
Default periodLast 30 daysPreset period of the chart.
Show latest mails10How many entries the dashboard lists show.
Permissions
The standard Joomla tab. Which action needs which permission is described in the chapter
Permissions, export and privacy .
Applies to version 1.0.4.
