#114: dataTransferMail.html

Observer activity notification email — sent to users who are watching a data transfer area (have userWantsToObserve=true). Notifies them about file actions by other users: uploads, renames, deletions, and external downloads.

Template variables

• message — dynamic message (typically: "The following activities were detected in the data transfer area 'AreaName' you observe.") — key plugins.datatransfer.mail.observe.message with {0} substitution
• auditEntries — list of recent audit log entries for the area (entire activity, not just downloads)
• downloadAuditEntries — filtered list: only DOWNLOAD events, shown in a separate section below
• link — direct URL to the data transfer area
• pf — formatter context: getI18nString() for i18n labels, getString() for date formatting

Content structure

1. i18n greeting message (message variable, pre-localized by i18n resources)
2. Activity table (all recent events):
   • Columns: Date, File name, Description, Action (eventType), Modified by
   • Iterates over auditEntries — each entry has timestamp, filenameAsString, descriptionAsString, eventType, byUserAsString
3. Action button: "Data transfer link" — styled as a clickable button with class="button", links to ${link}
4. Download events table (filtered to DOWNLOAD only):
   • Columns: Date, File name, Action, Downloaded by
   • Iterates over downloadAuditEntries
5. Shared mail closing/footer via #INCLUDE directives

The separation of auditEntries vs downloadAuditEntries allows the recipient to scan "who downloaded what" without scrolling through upload/rename noise.

Trigger

This template is rendered by DataTransferObserverNotificationJob (a scheduled job that runs periodically, queries audit entries with notified=false, groups them by area, and sends one email per observer). After sending, the notified flag on each audit entry is set to true to prevent duplicates.