The Queued Emails screen provides a centralized view of all emails awaiting dispatch from the GimCore system. This interface is crucial for monitoring email activity, diagnosing delivery issues, and ensuring timely communication. Administrators can review email details, manually retry sending, or remove emails from the queue.
To access this feature, navigate through the left-hand menu:
System ➡️ Queued Emails
Upon accessing the screen, the primary view displays a data table listing all emails currently in the queue.
Queued Emails Data Table
The data table provides a detailed breakdown of each email in the queue. Administrators can use this table to quickly identify and manage queued emails.
- Sent Attempts: Displays the number of times the system has attempted to send the email.
- Email Priority: Indicates the priority level assigned to the email, influencing its dispatch order.
- Email Type: Specifies the category or purpose of the email (e.g., notification, password reset).
- Email From: Shows the sender's email address.
- Email To: Displays the recipient's email address.
- Email Subject: Presents the subject line of the email.
- Sent Date: If applicable, this column shows the date and time the email was successfully sent. For queued emails, this will typically be blank until dispatched.
- Queue Date: Indicates the date and time the email was initially added to the queue.
- Actions: This column contains inline actions for managing individual queued emails.
- Edit (Pencil Icon) 📝: Click this icon to view or modify the details of a specific queued email. This opens a modal dialog for detailed inspection and potential manual re-queuing or status adjustment.
- Delete (Trash Can Icon) 🗑️: Click this icon to remove an email from the queue. A confirmation prompt will appear before permanent deletion.
Managing Queued Emails
The Queued Emails screen is primarily a monitoring and management interface. While new emails are automatically added to the queue by system processes, administrators can interact with existing queue entries.
Editing Queued Email Details 📝
To inspect or modify a queued email:
- Locate the desired email in the data table.
- Click the Edit (Pencil Icon) 📝 in the Actions column for that record.
- A modal dialog will appear, displaying detailed information about the email, such as its full content, send attempts, and recipient list. Depending on the system configuration, you might be able to manually adjust certain properties or trigger a re-send from this dialog. Note: Full configuration of email content or creation of new emails is typically handled by other modules that generate these queued emails.
- After reviewing or making any necessary changes, click Save or Close within the modal dialog.
Deleting Emails from the Queue 🗑️
To remove an email from the queue:
- Locate the email you wish to delete in the data table.
- Click the Delete (Trash Can Icon) 🗑️ in the Actions column for that record.
- A confirmation dialog will appear. Confirm your decision to permanently remove the email from the queue.
- Once confirmed, the email will be removed, and the system will no longer attempt to send it.
Search and Filter Options
Use the Search... bar located above the data table to quickly find specific emails within the queue. You can search by various criteria such as Email From, Email To, or Email Subject.
Best Practices for Queued Email Management
- Regular Monitoring: Periodically review the queued emails to identify any backlog or recurring issues that might prevent emails from being sent.
- Error Diagnosis: If a large number of emails are stuck in the queue with many send attempts, investigate system logs or SMTP server settings for potential configuration errors.
- Capacity Planning: A consistently large email queue might indicate a need to optimize email sending configurations or resource allocation for the email service.