Skip to content

Email templates

When the optional Send Email recipe (fedms-recipe/send_email) is installed, FedMS uses the Easy Email module to manage outbound notification templates declaratively.

Recipe required

Email templates only appear in the admin UI after the Send Email recipe is applied. See Recipes.

Where templates live

1
/admin/structure/easy_email_type

Each email type is a config entity describing one notification — its subject, its body (with tokens), its From address, its CC/BCC rules, and its attachments.

The templates that ship with FedMS cover the common notifications:

  • "Welcome to the platform" — sent on first login.
  • "You've been added to an event" — sent on membership add.
  • "Joining instructions for {event}" — sent N days before the event starts.
  • "Feedback request" — sent N days after the event ends.
  • "Task overdue" — sent when a task passes its due date.

Customers typically clone these templates and adapt them to their voice.

Tokens

Email templates support the standard Drupal tokens plus FedMS-specific tokens generated by the group_operations ECA model:

  • [user:*] — the recipient.
  • [group:*] — the relevant org/event/session.
  • [fedms_event:*] / [fedms_session:*] — the editorial content.
  • [fedms_task:*] — the relevant task (in task-driven mails).

For dynamic content (e.g. "use the right link for the selected virtual platform"), see fedms/components/eca#6.

Multi-language templates

Each template is fully translatable. Translations live alongside the template config entity and are applied based on the recipient's preferred language.

Sending an email from an ECA model

ECA models call the Send email action when they want to dispatch a notification. The action's parameters are the template ID and the recipient(s). The template handles everything else.

Override per event type

You can override a template per event type — for example, "Joining instructions" looks different for a virtual workshop than for an on-site workshop. This is tracked at fedms/components/federation#27 and fedms/components/federation#26.

Audit trail

Every email sent is logged. You can view the audit at /admin/reports/email (when the Easy Email reporting plugin is installed).

Next steps