mirror of
https://github.com/mattermost/mattermost.git
synced 2025-02-25 18:55:24 -06:00
12a9180807
* Implementation to Make all Mattermost system emails Multi-Part, with both a HTML and Plain Text version * update lib * update code per review * update to use the mattermost repo
266 lines
9.5 KiB
Go
266 lines
9.5 KiB
Go
// Copyright (c) 2016-present Mattermost, Inc. All Rights Reserved.
|
|
// See License.txt for license information.
|
|
|
|
package app
|
|
|
|
import (
|
|
"fmt"
|
|
"html/template"
|
|
"strconv"
|
|
"time"
|
|
|
|
"github.com/mattermost/platform/model"
|
|
"github.com/mattermost/platform/utils"
|
|
|
|
l4g "github.com/alecthomas/log4go"
|
|
"github.com/nicksnyder/go-i18n/i18n"
|
|
)
|
|
|
|
const (
|
|
EMAIL_BATCHING_TASK_NAME = "Email Batching"
|
|
)
|
|
|
|
var emailBatchingJob *EmailBatchingJob
|
|
|
|
func InitEmailBatching() {
|
|
if *utils.Cfg.EmailSettings.EnableEmailBatching {
|
|
if emailBatchingJob == nil {
|
|
emailBatchingJob = MakeEmailBatchingJob(*utils.Cfg.EmailSettings.EmailBatchingBufferSize)
|
|
}
|
|
|
|
// note that we don't support changing EmailBatchingBufferSize without restarting the server
|
|
|
|
emailBatchingJob.Start()
|
|
}
|
|
}
|
|
|
|
func AddNotificationEmailToBatch(user *model.User, post *model.Post, team *model.Team) *model.AppError {
|
|
if !*utils.Cfg.EmailSettings.EnableEmailBatching {
|
|
return model.NewLocAppError("AddNotificationEmailToBatch", "api.email_batching.add_notification_email_to_batch.disabled.app_error", nil, "")
|
|
}
|
|
|
|
if !emailBatchingJob.Add(user, post, team) {
|
|
l4g.Error(utils.T("api.email_batching.add_notification_email_to_batch.channel_full.app_error"))
|
|
return model.NewLocAppError("AddNotificationEmailToBatch", "api.email_batching.add_notification_email_to_batch.channel_full.app_error", nil, "")
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
type batchedNotification struct {
|
|
userId string
|
|
post *model.Post
|
|
teamName string
|
|
}
|
|
|
|
type EmailBatchingJob struct {
|
|
newNotifications chan *batchedNotification
|
|
pendingNotifications map[string][]*batchedNotification
|
|
}
|
|
|
|
func MakeEmailBatchingJob(bufferSize int) *EmailBatchingJob {
|
|
return &EmailBatchingJob{
|
|
newNotifications: make(chan *batchedNotification, bufferSize),
|
|
pendingNotifications: make(map[string][]*batchedNotification),
|
|
}
|
|
}
|
|
|
|
func (job *EmailBatchingJob) Start() {
|
|
if task := model.GetTaskByName(EMAIL_BATCHING_TASK_NAME); task != nil {
|
|
task.Cancel()
|
|
}
|
|
|
|
l4g.Debug(utils.T("api.email_batching.start.starting"), *utils.Cfg.EmailSettings.EmailBatchingInterval)
|
|
model.CreateRecurringTask(EMAIL_BATCHING_TASK_NAME, job.CheckPendingEmails, time.Duration(*utils.Cfg.EmailSettings.EmailBatchingInterval)*time.Second)
|
|
}
|
|
|
|
func (job *EmailBatchingJob) Add(user *model.User, post *model.Post, team *model.Team) bool {
|
|
notification := &batchedNotification{
|
|
userId: user.Id,
|
|
post: post,
|
|
teamName: team.Name,
|
|
}
|
|
|
|
select {
|
|
case job.newNotifications <- notification:
|
|
return true
|
|
default:
|
|
// return false if we couldn't queue the email notification so that we can send an immediate email
|
|
return false
|
|
}
|
|
}
|
|
|
|
func (job *EmailBatchingJob) CheckPendingEmails() {
|
|
job.handleNewNotifications()
|
|
|
|
// it's a bit weird to pass the send email function through here, but it makes it so that we can test
|
|
// without actually sending emails
|
|
job.checkPendingNotifications(time.Now(), sendBatchedEmailNotification)
|
|
|
|
l4g.Debug(utils.T("api.email_batching.check_pending_emails.finished_running"), len(job.pendingNotifications))
|
|
}
|
|
|
|
func (job *EmailBatchingJob) handleNewNotifications() {
|
|
receiving := true
|
|
|
|
// read in new notifications to send
|
|
for receiving {
|
|
select {
|
|
case notification := <-job.newNotifications:
|
|
userId := notification.userId
|
|
|
|
if _, ok := job.pendingNotifications[userId]; !ok {
|
|
job.pendingNotifications[userId] = []*batchedNotification{notification}
|
|
} else {
|
|
job.pendingNotifications[userId] = append(job.pendingNotifications[userId], notification)
|
|
}
|
|
default:
|
|
receiving = false
|
|
}
|
|
}
|
|
}
|
|
|
|
func (job *EmailBatchingJob) checkPendingNotifications(now time.Time, handler func(string, []*batchedNotification)) {
|
|
// look for users who've acted since pending posts were received
|
|
for userId, notifications := range job.pendingNotifications {
|
|
schan := Srv.Store.Status().Get(userId)
|
|
pchan := Srv.Store.Preference().Get(userId, model.PREFERENCE_CATEGORY_NOTIFICATIONS, model.PREFERENCE_NAME_EMAIL_INTERVAL)
|
|
batchStartTime := notifications[0].post.CreateAt
|
|
|
|
// check if the user has been active and would've seen any new posts
|
|
if result := <-schan; result.Err != nil {
|
|
l4g.Error(utils.T("api.email_batching.check_pending_emails.status.app_error"), result.Err)
|
|
delete(job.pendingNotifications, userId)
|
|
continue
|
|
} else if status := result.Data.(*model.Status); status.LastActivityAt >= batchStartTime {
|
|
delete(job.pendingNotifications, userId)
|
|
continue
|
|
}
|
|
|
|
// get how long we need to wait to send notifications to the user
|
|
var interval int64
|
|
if result := <-pchan; result.Err != nil {
|
|
// use the default batching interval if an error ocurrs while fetching user preferences
|
|
interval, _ = strconv.ParseInt(model.PREFERENCE_EMAIL_INTERVAL_BATCHING_SECONDS, 10, 64)
|
|
} else {
|
|
preference := result.Data.(model.Preference)
|
|
|
|
if value, err := strconv.ParseInt(preference.Value, 10, 64); err != nil {
|
|
// // use the default batching interval if an error ocurrs while deserializing user preferences
|
|
interval, _ = strconv.ParseInt(model.PREFERENCE_EMAIL_INTERVAL_BATCHING_SECONDS, 10, 64)
|
|
} else {
|
|
interval = value
|
|
}
|
|
}
|
|
|
|
// send the email notification if it's been long enough
|
|
if now.Sub(time.Unix(batchStartTime/1000, 0)) > time.Duration(interval)*time.Second {
|
|
go handler(userId, notifications)
|
|
delete(job.pendingNotifications, userId)
|
|
}
|
|
}
|
|
}
|
|
|
|
func sendBatchedEmailNotification(userId string, notifications []*batchedNotification) {
|
|
uchan := Srv.Store.User().Get(userId)
|
|
|
|
var user *model.User
|
|
if result := <-uchan; result.Err != nil {
|
|
l4g.Warn("api.email_batching.send_batched_email_notification.user.app_error")
|
|
return
|
|
} else {
|
|
user = result.Data.(*model.User)
|
|
}
|
|
|
|
translateFunc := utils.GetUserTranslations(user.Locale)
|
|
displayNameFormat := *utils.Cfg.TeamSettings.TeammateNameDisplay
|
|
|
|
var contents string
|
|
for _, notification := range notifications {
|
|
var sender *model.User
|
|
schan := Srv.Store.User().Get(notification.post.UserId)
|
|
if result := <-schan; result.Err != nil {
|
|
l4g.Warn(utils.T("api.email_batching.render_batched_post.sender.app_error"))
|
|
continue
|
|
} else {
|
|
sender = result.Data.(*model.User)
|
|
}
|
|
|
|
var channel *model.Channel
|
|
cchan := Srv.Store.Channel().Get(notification.post.ChannelId, true)
|
|
if result := <-cchan; result.Err != nil {
|
|
l4g.Warn(utils.T("api.email_batching.render_batched_post.channel.app_error"))
|
|
continue
|
|
} else {
|
|
channel = result.Data.(*model.Channel)
|
|
}
|
|
|
|
emailNotificationContentsType := model.EMAIL_NOTIFICATION_CONTENTS_FULL
|
|
if utils.IsLicensed() && *utils.License().Features.EmailNotificationContents {
|
|
emailNotificationContentsType = *utils.Cfg.EmailSettings.EmailNotificationContentsType
|
|
}
|
|
|
|
contents += renderBatchedPost(notification, channel, sender, *utils.Cfg.ServiceSettings.SiteURL, displayNameFormat, translateFunc, user.Locale, emailNotificationContentsType)
|
|
}
|
|
|
|
tm := time.Unix(notifications[0].post.CreateAt/1000, 0)
|
|
|
|
subject := translateFunc("api.email_batching.send_batched_email_notification.subject", len(notifications), map[string]interface{}{
|
|
"SiteName": utils.Cfg.TeamSettings.SiteName,
|
|
"Year": tm.Year(),
|
|
"Month": translateFunc(tm.Month().String()),
|
|
"Day": tm.Day(),
|
|
})
|
|
|
|
body := utils.NewHTMLTemplate("post_batched_body", user.Locale)
|
|
body.Props["SiteURL"] = *utils.Cfg.ServiceSettings.SiteURL
|
|
body.Props["Posts"] = template.HTML(contents)
|
|
body.Props["BodyText"] = translateFunc("api.email_batching.send_batched_email_notification.body_text", len(notifications))
|
|
|
|
if err := utils.SendMail(user.Email, subject, body.Render()); err != nil {
|
|
l4g.Warn(utils.T("api.email_batchings.send_batched_email_notification.send.app_error"), user.Email, err)
|
|
}
|
|
}
|
|
|
|
func renderBatchedPost(notification *batchedNotification, channel *model.Channel, sender *model.User, siteURL string, displayNameFormat string, translateFunc i18n.TranslateFunc, userLocale string, emailNotificationContentsType string) string {
|
|
// don't include message contents if email notification contents type is set to generic
|
|
var template *utils.HTMLTemplate
|
|
if emailNotificationContentsType == model.EMAIL_NOTIFICATION_CONTENTS_FULL {
|
|
template = utils.NewHTMLTemplate("post_batched_post_full", userLocale)
|
|
} else {
|
|
template = utils.NewHTMLTemplate("post_batched_post_generic", userLocale)
|
|
}
|
|
|
|
template.Props["Button"] = translateFunc("api.email_batching.render_batched_post.go_to_post")
|
|
template.Props["PostMessage"] = GetMessageForNotification(notification.post, translateFunc)
|
|
template.Props["PostLink"] = siteURL + "/" + notification.teamName + "/pl/" + notification.post.Id
|
|
template.Props["SenderName"] = sender.GetDisplayName(displayNameFormat)
|
|
|
|
tm := time.Unix(notification.post.CreateAt/1000, 0)
|
|
timezone, _ := tm.Zone()
|
|
|
|
template.Props["Date"] = translateFunc("api.email_batching.render_batched_post.date", map[string]interface{}{
|
|
"Year": tm.Year(),
|
|
"Month": translateFunc(tm.Month().String()),
|
|
"Day": tm.Day(),
|
|
"Hour": tm.Hour(),
|
|
"Minute": fmt.Sprintf("%02d", tm.Minute()),
|
|
"Timezone": timezone,
|
|
})
|
|
|
|
if channel.Type == model.CHANNEL_DIRECT {
|
|
template.Props["ChannelName"] = translateFunc("api.email_batching.render_batched_post.direct_message")
|
|
} else if channel.Type == model.CHANNEL_GROUP {
|
|
template.Props["ChannelName"] = translateFunc("api.email_batching.render_batched_post.group_message")
|
|
} else {
|
|
// don't include channel name if email notification contents type is set to generic
|
|
if emailNotificationContentsType == model.EMAIL_NOTIFICATION_CONTENTS_FULL {
|
|
template.Props["ChannelName"] = channel.DisplayName
|
|
} else {
|
|
template.Props["ChannelName"] = translateFunc("api.email_batching.render_batched_post.notification")
|
|
}
|
|
}
|
|
|
|
return template.Render()
|
|
}
|