Mails Module – User Guide

The Mail Module provides WordPress administrators with a comprehensive email logging, monitoring, and
sending system. Every email sent via wp_mail() — whether from WordPress core, plugins, or themes — is
captured and stored in a searchable, filterable log with full metadata including delivery time, attachments, headers,
and originating plugin.

Additionally, the module allows you to configure an external SMTP provider for email delivery,
compose and send new emails directly from the admin, and resend previously sent
messages.

Enable / Disable the Module

The Mail module is a standalone module inside Advanced Analytics. You can enable or disable it without affecting any
other part of the plugin or WordPress email delivery itself.

1. Navigate to Error Logs → Settings in the WordPress admin sidebar.
2. Click the “Mail Options” tab (or scroll to the section headed Mail options).
3. Toggle the “Enable email logging module” checkbox.
4. Click Save Changes.

Module Settings

The Mail Options tab on the Settings page contains the following module-level settings:

SMTP Provider Settings

The Mail Options tab also includes an External SMTP Provider section. When configured, all WordPress
emails will be routed through your external SMTP server instead of the server’s default mail handler (PHP
mail() or sendmail).

Popular SMTP Provider Configuration Examples

Sending a Test Email

After configuring SMTP settings, verify your configuration works by sending a test email:

1. In the Mail Options settings tab, scroll to the “Test Mail Delivery” section.
2. Enter a recipient email address in the test field.
3. Click “Send test mail”.
4. A loading overlay appears while the email is being sent via AJAX.
5. On success, you’ll see a “Test email sent successfully” alert. Check your inbox to confirm delivery.

Mail Log List

This is the main screen. It shows every email sent (or attempted) by your WordPress site in a sortable, filterable table
with full metadata.

Columns

Row Actions

Hover over any mail log row to reveal these actions:

• Details — Opens a modal overlay showing the full email body, all headers, attachment info,
  delivery time, and metadata.
• Resend — Re-sends the email with its original content and recipients. Only available for
  non-time-sensitive emails (see Resending).
• Delete — Removes the log entry from the database.

Status Indicators

Each row indicates the delivery status:

• Successful — Email was accepted for delivery by the mail server.
• Failed — Email delivery failed. The error message is stored and visible in
  the details modal.

Filters & Views

View Tabs

Above the table you will find quick-filter links. Each shows a count in parentheses:

Dropdown Filters

Use the dropdown menus above the table then click Filter:

Searching Mail Logs

Use the search box in the top-right corner of the list page. The search queries across all columns —
you can search by recipient, sender, subject, message content, or any other stored field.

• Type your search term and press Enter or click Search.
• The search is case-insensitive.
• To clear the search, empty the box and press Enter.

Viewing Mail Details

Click Details on any row to open a modal popup showing the full email information:

The modal also includes Copy to clipboard and Share buttons for the email content.

Resending an Email

You can resend any previously logged email, provided it is not time-sensitive.

1. Find the email in the log list.
2. Hover over its row and click Resend (if available).
3. The email is re-sent with its original To, CC, BCC, Reply-To, Subject, Body, and Attachments.
4. A success or error notice appears at the top of the page.

Composing a New Email

You can compose and send new emails directly from the WordPress admin, complete with a rich-text editor, attachments,
and full header control.

1. On the Mail Log list page, click “Compose New” (top of the page).
2. Fill in the form fields:
   • To (required) — Recipient email address(es), comma-separated for multiple.
   • CC (optional) — Carbon-copy recipients, comma-separated.
   • BCC (optional) — Blind carbon-copy recipients, comma-separated.
   • Reply-To (optional) — Reply-to email address.
   • Subject (required) — Email subject line.
   • Attachments (optional) — Select files from the WordPress Media Library.
   • Message (required) — Compose your email using the WordPress editor with full rich-text
     formatting and media insertion.
3. Click Send to dispatch the email.

Email Categories

Every logged email is automatically categorized based on keywords detected in its subject and body. This helps you
quickly identify the type of emails your site sends.

Attachments

The Mail module captures complete attachment information for every logged email:

• Attachment Count — Number of files attached.
• Attachment Total Size — Combined file size of all attachments.
• File Details — Each attachment records its URL, filename, MIME type, and media library icon.

Attachment Sources

• Media Library files — Attachments found in the WordPress media library display with their icon,
  name, and a clickable URL.
• Non-library files — Files not in the media library (e.g., dynamically generated PDFs) are
  recorded with their file path and a note indicating they’re external to the media library.

Bulk Actions

Perform operations on multiple mail log entries at once:

1. Check the boxes next to the entries you want to act on. Use the checkbox in the header row to select all visible
   entries.
2. Open the Bulk actions dropdown.
3. Choose Delete to permanently remove all selected entries.
4. Click Apply.

CSV Export

Export the currently filtered/displayed mail logs to a CSV file:

1. Apply any desired filters or search (the export respects your current filter context).
2. Click the “CSV Export” button above the table.
3. A progress bar appears during the export. You can click Cancel if needed.
4. The CSV file downloads automatically once complete.

Screen Options

Click Screen Options (top-right of the page, just below the admin bar) to customize the display:

Auto-Clear Schedule

To prevent the mail log database table from growing indefinitely, you can configure automatic clearing:

1. Navigate to Error Logs → Settings and open the Mail Options tab.
2. Select a schedule from the “Auto-clear mail logs” dropdown:
   • Never — Logs are kept forever (manual deletion only).
   • Daily / Weekly / Monthly / Yearly — The entire mail log table is truncated on the
     selected schedule.
3. Click Save Changes.

A WordPress cron job (aadvana_mail_logging_clear) is scheduled to run at the configured interval. Changing
the schedule updates the cron job automatically.

Multisite Networks

On WordPress multisite installations, the Mail module provides additional capabilities:

• Blog ID tracking — Every logged email records which site (blog ID) triggered it.
• Site filter dropdown — Network administrators can filter the list to show emails from a
  specific site.
• Per-site logs — Each site in the network has its emails logged separately with site
  identification.

Troubleshooting