Email Logs

89 Aufrufe Markdown

Check every e-mail the system handed to the mail module, and read the exact message a client received without asking them to forward it.

Opening the Screen

Open {admin}/tools/mail-logs from the Tools menu.

What Is on the Screen

One table, newest record first, with a search box above it. The search covers the subject line and the recipient addresses. The download button beside the search box exports the filtered list as CSV, JSON or XML.

Subject The subject line as it was sent. Long subjects are shortened, and the whole of it appears on hover.
Addresses Who received it. With more than one recipient the first address appears followed by a counter for the rest.
Date When the message left the system.
IP Address The address the request came from. The lookup button beside it finds the other records from the same address.
Preview The eye button at the end of a row opens the message.

Preview window

The Email Preview window shows the subject, the recipients and the send time at the top. Under Message Content the message appears exactly as it was sent, with its own layout and images.

Fields

These two belong to the Clear Logs dialog, opened by the red button next to the page title. Both are required.

Select Date The cut-off. Every e-mail record from before this date goes, while that day's own records stay. No default: pick a date each time.
Enter your account password for security verification. Your own panel password, confirming the deletion came from you.

Tasks

Read a message a client received

  1. Type the client's e-mail address in the search box.
  2. Find the row by its subject and date.
  3. Click the eye button. The message opens in the preview window with its recipients and time.

Check whether a message went out

  1. Search for the address, then compare the Date column with the moment the client expected the e-mail.
  2. A row means the message was handed over for sending. No row means it never got that far, so check the notification template and the mail module settings.

Clear old records

  1. Click the Clear Logs button.
  2. Pick a cut-off date and type your account password.
  3. Click Confirm. The matching records go and the page reloads with the shorter list.

Things to Watch

Nothing removes these records but you

E-mail records have no retention period and stay until you clear them or delete the client they belong to. On a busy installation the table grows without limit, so clear it on a routine you choose. Deletion cannot be undone, and the same records fill the Messages list in the client's own panel: what you clear here disappears from there as well.

Verification messages have no body

Activation codes, password-reset links, sub-user invitations and domain transfer codes record the send event, the subject and the recipient, but their body is replaced by a short notice. Anyone reading the log must not be able to reuse a code that was meant for one inbox.

A row is a hand-off, not a delivery receipt

The record is written once the mail module accepts the message. What happens afterwards, greylisting, a spam folder or a bouncing mailbox, does not appear here. For that, check the mail provider's own reports.

Required Privileges

The preview and the Clear Logs dialog both need TOOLS_ACTIONS. The download button beside the search box follows the panel-wide TABLE_EXPORT; an account without that privilege never sees the button.

War das hilfreich?

Vielen Dank für Ihre Rückmeldung!

Brauchen Sie weitere Hilfe?

Unser Support-Team ist rund um die Uhr für Sie da, wenn Sie oben nicht fündig werden.