Plugin name: JEM Mailer Plugin
Extension: plg_jem_mailer
Plugin group: JEM
Applies to: JEM 5.0 beta 3 for Joomla 5/6 and JEM 4.5 beta 5 for Joomla 4/5, when the plugin is available in the installed package.
Overview
The JEM Mailer Plugin sends notification emails when important JEM actions occur: event registration, waiting list changes, unregistration, new or edited events, and new or edited venues.
The plugin can notify different recipient groups depending on the action: the attendee, the event or venue originator, administrators, category email recipients, category ACL recipients, JEM group members, registered attendees, and creators of events attached to an edited venue.
Requirements
- JEM component installed and enabled.
- The plugin enabled in System → Manage → Plugins.
- Joomla mail configuration working correctly.
- Valid recipient email addresses in users, categories, administrator settings, or distribution lists.
Registration Notifications
These options control emails sent when users register for an event, are moved on or off the waiting list, or unregister from an event.
| Action | Recipient | Default | Description |
|---|
| Registration |
Attendee |
Yes |
Sends confirmation to the user who registered or was registered by another user. |
| Registration |
Creator, Admin, Category, Group |
No |
Optional notifications to event creator, administrators, category email list, or category group. |
| Waiting list on/off |
Attendee |
Yes |
Notifies the user when moved to or from the waiting list. |
| Waiting list on/off |
Creator, Admin, Category, Group |
No |
Optional notifications for waiting list movement. |
| Unregistration |
Attendee |
Yes |
Sends confirmation when the user deregisters or is removed from an event. |
| Unregistration |
Creator, Admin, Category, Group |
No |
Optional notifications when attendee status changes by unregistration. |
Event Notifications
| Action | Recipient | Default | Description |
|---|
| New event |
Originator |
No |
Sends confirmation to the user who submitted the event. |
| New event |
Admin |
No |
Notifies configured administrators of a new event submission. |
| New event |
Category |
No |
Sends to email addresses configured in the event category email field. |
| New event |
Category ACL |
No |
Sends to users belonging to Joomla groups configured through category ACL email settings. |
| New event |
Group |
No |
Sends to JEM group members associated with the event category. |
| Edit event |
Originator, Creator, Admin, Registered, Category, Category ACL, Group |
No |
Optional notifications when an event is edited or its publishing state changes. |
Venue Notifications
| Action | Recipient | Default | Description |
|---|
| New venue |
Originator |
No |
Sends confirmation to the user who submitted the venue. |
| New venue |
Admin |
No |
Notifies administrators of a new venue submission. |
| Edit venue |
Originator, Creator, Event Creator, Admin, Registered, Category, Group |
No |
Optional notifications when a venue is edited. Some recipients are calculated through events attached to that venue. |
Administrator Options
| Option | Default | Description |
|---|
| System Mail receivers |
No |
If enabled, Joomla users allowed to receive system emails can receive admin notification mails. |
| Distribution list |
Empty |
Comma-separated email addresses that should receive administrator notifications. Invalid addresses are ignored. |
| Send as HTML |
No |
If enabled, notification emails are sent as HTML and line breaks are converted to <br>. |
Recipient Types
| Recipient Type | Meaning |
|---|
| Attendee |
The user affected by event registration, waiting list, invitation, refusal, or unregistration. |
| Originator |
The logged-in user who submitted or edited the event or venue. |
| Creator |
The original creator of the item, when different from the current editor. |
| Admin |
Configured administrator recipients from system-mail users and/or the distribution list. |
| Registered |
Users registered, invited, not attending, attending, or waiting for the event. |
| Category |
Email addresses stored in the category email field. |
| Category ACL |
Users from Joomla groups configured through category ACL email settings. |
| Group |
Members of the JEM group associated with the event category. |
| Event Creator |
Creators of events attached to a venue that has been edited. |
Triggered Actions
onEventUserRegistered: sends registration, invitation, refusal, and waiting-list registration emails.onUserOnOffWaitinglist: sends emails when an attendee moves between waiting and attending lists.onEventUserUnregistered: sends unregistration emails.onEventEdited: sends new or edited event notifications.onVenueEdited: sends new or edited venue notifications.onContentChangeState: triggers event or venue notifications when publishing state changes.
Email Content
Email text is generated from Joomla language strings. Messages can include event title, date, time, venue, city, places, description, direct link, submission time, modified time, publishing state, and online meeting details when available.
When a recipient receives a message because of an indirect role, the plugin can append a reason such as administrator, item creator, JEM group member, category mailing list, or attendee.
Recommended Configurations
Simple Registration Confirmations
- Registration → Attendee: Yes
- Waiting list → Attendee: Yes
- Unregistration → Attendee: Yes
- Admin recipients: Disabled
Best for sites where users only need personal confirmation emails.
Moderated Event Submissions
- New event → Originator: Yes
- New event → Admin: Yes
- Distribution list: Event manager emails
- Send as HTML: Optional
Best when frontend users submit events that need administrator review.
Troubleshooting
| Problem | Possible Cause | Suggested Fix |
|---|
| No emails are sent. |
Plugin disabled, Joomla mail not configured, or all notification options disabled. |
Enable the plugin, test Joomla mail, and enable the relevant recipient options. |
| Admins do not receive emails. |
No distribution list, system mail receivers disabled, or users do not have “Receive System Emails”. |
Add addresses to the distribution list or enable system mail receivers and check user settings. |
| Category emails are not sent. |
Category email fields are empty or invalid. |
Check category email configuration and use valid comma-separated email addresses. |
| Registered users receive too many emails. |
Registered recipient notifications are enabled for event or venue edits. |
Disable registered notifications unless attendees must be informed about every change. |
| Emails are plain text. |
Send as HTML is disabled. |
Enable Send as HTML if HTML-formatted email output is desired. |
Related Development Notes
The following GitHub references are useful for understanding mailer behaviour, category ACL mail, registration-related notifications, and plugin events.
