JEM Mailer Plugin

The JEM Mailer Plugin sends email notifications when registration, event or venue actions occur. Depending on its configuration, messages can be sent to attendees, submitters, creators, administrators, category recipients, Joomla ACL groups, JEM groups and confirmed event attendees.

JEM 5.1.0 Beta 4 extends the mailer with editable multilingual templates, named variables, shared footer and data-protection content, persistent delivery history, retries, controlled resends and scheduled event reminders.

Requirements

• The JEM component must be installed and enabled.
• The JEM - Mailer Plugin must be enabled.
• Joomla mail delivery must be configured correctly in System → Global Configuration → Server → Mail.
• Recipient users must have valid email addresses and must not be blocked.
• Category, group or distribution-list recipients must be configured before enabling those destinations.
• Scheduled reminders in JEM 5.1.0 require Joomla Scheduled Tasks to run regularly on the server.

Where To Configure The Plugin

1. Open System → Manage → Plugins.
2. Search for JEM - Mailer Plugin.
3. Enable the plugin.
4. Open the plugin to configure its notification profile and recipient matrix.
5. Save the plugin before testing email delivery.

Configuration Layers

Profiles And Recipient Matrix

The plugin provides four presets. Selecting a preset replaces the complete recipient matrix. Changing an individual checkbox afterwards creates a custom combination.

Registration Notifications

Registration messages cover confirmed attendance, waiting-list registration, invitations, a Not Attending response, waiting-list movement and removal of a registration.

The attendee message can also distinguish between an action performed by the attendee and an action performed on behalf of another user.

Event Notifications

The Registered Attendees recipient currently includes confirmed, non-waiting registrations for events which have not finished more than one hour earlier. Waiting-list, invited and Not Attending records are not included in this recipient group.

Venue Notifications

When a venue is edited, JEM can find events assigned to that venue and notify their creators, category recipients, JEM groups or confirmed attendees.

Recipient Types

When the same email address is found through several recipient roles, JEM removes duplicates. The message can include an explanation of why the recipient received it, such as administrator, item creator, category recipient or JEM group member.

Administrator Options

Global JEM Settings That Affect Email

The plugin configuration chooses recipients, but some message values come from global JEM Settings.

Triggered Plugin Actions

• onEventUserRegistered: registration, attendance status, invitation and waiting-list confirmation.
• onUserOnOffWaitinglist: movement between the waiting and attending lists.
• onEventUserUnregistered: registration removal.
• onEventEdited: new or edited event.
• onVenueEdited: new or edited venue.
• onContentChangeState: event or venue publication-state change.
• onJemNotificationAction: controlled retry or resend in JEM 5.1.0.

JEM 5.0.1 And JEM 5.0.2 Email Content

In JEM 5.0.1 and JEM 5.0.2 Beta 1, notification text comes from the installed JEM Mailer language files. To change the wording, use an appropriate Joomla language override.

The named-variable template editor, shared notification content, persistent notification history and scheduled reminders described below are specific to JEM 5.1.0 Beta 4.

JEM 5.1.0 Beta 4 Appendix

Advanced Operating Profile

Notification administration and reminder automation are available when JEM uses the Advanced operating profile. The Essential profile continues to support the core Mailer notification workflow but does not expose the advanced template and reminder administration interfaces.

The advanced Notifications area contains five sections:

• Templates: reservation and reminder message templates.
• Footer: common content appended to messages.
• Data Protection: optional privacy notice.
• Reminders: reusable reminder intervals.
• History: persisted reservation notifications and delivery attempts.

Global Notification Settings

Open JEM Settings → Notifications to configure the global policy.

The same page shows whether the JEM Joomla Scheduled Task is installed and active, and provides a link to open it.

Notification Templates

Open JEM Control Panel → Notifications → Templates. Templates can be filtered by language, workflow, recipient, source and identifier.

The default text continues to come from the JEM language files. A customised version is stored by Joomla for the selected language and is preserved during normal JEM updates.

Each template contains:

• A required subject with a maximum length of 255 characters.
• A required plain-text body.
• An optional HTML body.
• A preview using example data.
• A list of allowed named variables.
• A tool for generating basic HTML from the plain-text body.
• A Restore Default action which removes only the selected language customisation.

Template Workflows

Available Template Variables

Variables use literal names inside braces, for example {event_title}. Variable names are internal identifiers and must never be translated.

Shared Footer And Data-Protection Variables

The shared Footer and Data Protection sections use a smaller variable set:

Variable Rules

• Use the exact lowercase identifier, including underscores.
• Do not translate variable names.
• Do not add spaces inside the braces.
• Unknown variables are rejected when the template is saved.
• Legacy positional markers such as %s must not be entered in a customised template.
• The editor converts translated legacy defaults into named variables before presenting them for editing.
• Missing recommended variables generate a warning, not a fatal validation error.
• Values inserted into an HTML template are escaped before rendering.

Template Example

Subject:

{site_name}: Registration confirmed for {event_title}

Plain-text body:

Hello {user_name},

Your registration for {event_title} is confirmed.

Date: {event_date}
Time: {event_time}
Venue: {venue}
City: {city}
Places: {places}

Event details:
{event_url}

Your reservation:
{reservation_url}

HTML body:

<h2>Registration confirmed</h2>
<p>Hello <strong>{user_name}</strong>,</p>
<p>Your registration for <strong>{event_title}</strong> is confirmed.</p>
<ul>
    <li>Date: {event_date}</li>
    <li>Time: {event_time}</li>
    <li>Venue: {venue}</li>
    <li>Places: {places}</li>
</ul>
<p><a href="/{reservation_url}">Open your reservation</a></p>

Footer And Data Protection

The shared sections are appended in this order:

1. Footer.
2. Data Protection notice.

Each language can have different shared content. The Data Protection section also stores the absolute privacy-policy URL used by {privacy_url}.

Scheduled Reminders

JEM installs three reusable reminder definitions:

• 7 days before.
• 24 hours before.
• 2 hours before.

Administrators can publish, reorder, edit or add reminder definitions using minutes, hours, days or weeks. Internally, JEM stores the resulting interval in minutes.

Reminder Configuration Workflow

1. Select the global Advanced operating profile.
2. Open JEM Settings → Notifications.
3. Enable event reminders.
4. Confirm that the Joomla Scheduled Task reports an active status.
5. Open JEM Control Panel → Notifications → Reminders.
6. Review the reminder definitions and their Default for new events status.
7. Create or edit an event.
8. Open the event's Notifications section.
9. Enable reminders and select one or more intervals.
10. For recurring or custom-date events, optionally apply the selection to the complete series.

A reminder definition marked as Default for new events is preselected only for events created after global reminders are enabled. Existing events are not changed automatically.

Reminder Eligibility

A scheduled reminder is created only when:

• JEM uses a profile which permits notification automation.
• Global reminders are enabled.
• The event has at least one published reminder interval selected.
• The registration is confirmed.
• The registration is not on the waiting list.
• The Joomla user is active, unblocked and has a valid email address.
• The event has a date and is not cancelled.
• The calculated reminder time is still in the future.

For all-day events, the configured reference time is interpreted in the effective event timezone. Open-date events do not receive reminders.

Notification History, Retry And Resend

JEM 5.1.0 stores an immutable snapshot of every catalogued reservation notification and scheduled reminder. The snapshot includes the recipient, resolved language, rendered subject, rendered content, reservation revision, state and delivery attempts.

The persistent history currently applies to catalogued reservation, attendance, cancellation, waiting-list and reminder messages. General event and venue submission emails are not stored in this notification history.

Notification Permissions

Recommended Configurations

Troubleshooting

GitHub References

• JEM 5.0.1 Mailer source
• JEM 5.0.2 Mailer source
• JEM 5.1.0 Mailer source
• Editable notification templates and shared mail content
• Persistent reservation notifications and resend history
• Scheduled reservation reminders
• Issue #1933: Category versus Category ACL recipients
• Issue #1570: Email to users in event ACL groups
• Issue #1959: JEM plugin events