public static void Send(string fromEmail, string fromName, string subject, List <string> recipients, string message, string appRoot = "", string themeRoot = "", List <Attachment> attachments = null, bool createCommunicationHistory = true)
{
var errorMessages = new List <string>();
var emailMessage = new RockEmailMessage();
emailMessage.FromEmail = fromEmail;
emailMessage.FromName = fromName;
emailMessage.Subject = subject;
emailMessage.SetRecipients(recipients);
emailMessage.Message = message;
emailMessage.ThemeRoot = themeRoot;
emailMessage.AppRoot = appRoot;
emailMessage.CreateCommunicationRecord = createCommunicationHistory;
if (attachments != null)
{
foreach (var attachment in attachments)
{
var binaryFile = new BinaryFile();
binaryFile.ContentStream = attachment.ContentStream;
binaryFile.FileName = attachment.Name;
emailMessage.Attachments.Add(binaryFile);
}
}
emailMessage.Send(out errorMessages);
}
public static void Send(Guid emailTemplateGuid, List <RecipientData> recipients, string appRoot = "", string themeRoot = "", bool createCommunicationHistory = true)
{
using (var rockContext = new RockContext())
{
var template = new SystemEmailService(rockContext).Get(emailTemplateGuid);
if (template != null)
{
var errorMessages = new List <string>();
var message = new RockEmailMessage(template);
message.SetRecipients(recipients);
message.ThemeRoot = themeRoot;
message.AppRoot = appRoot;
message.CreateCommunicationRecord = createCommunicationHistory;
message.Send(out errorMessages);
}
}
}
private static CreateMessageResult CreateEmailMessage(Person person, Dictionary <string, object> mergeObjects, SystemCommunication systemCommunication)
{
var createMessageResult = new CreateMessageResult();
if (string.IsNullOrWhiteSpace(person.Email))
{
var warning = $"{person.FullName} does not have an email address entered.";
createMessageResult.Warnings.Add(warning);
RockLogger.Log.Warning(RockLogDomains.Jobs, warning);
return(createMessageResult);
}
if (!person.IsEmailActive)
{
var warning = $"{person.FullName.ToPossessive()} email address is inactive.";
createMessageResult.Warnings.Add(warning);
RockLogger.Log.Warning(RockLogDomains.Jobs, warning);
return(createMessageResult);
}
if (person.EmailPreference == EmailPreference.DoNotEmail)
{
var warning = $"{person.FullName} is marked as do not email.";
createMessageResult.Warnings.Add(warning);
RockLogger.Log.Warning(RockLogDomains.Jobs, warning);
return(createMessageResult);
}
var recipients = new List <RockMessageRecipient>
{
new RockEmailMessageRecipient(person, mergeObjects)
};
var message = new RockEmailMessage(systemCommunication);
message.SetRecipients(recipients);
createMessageResult.Message = message;
return(createMessageResult);
}
/// <summary>
/// Notifies the admins.
/// </summary>
/// <param name="subject">The subject.</param>
/// <param name="message">The message.</param>
/// <param name="appRoot">The application root.</param>
/// <param name="themeRoot">The theme root.</param>
/// <param name="createCommunicationHistory">if set to <c>true</c> [create communication history].</param>
/// <exception cref="System.Exception">Error sending System Email: Could not read Email Medium Entity Type</exception>
public static void NotifyAdmins(string subject, string message, string appRoot = "", string themeRoot = "", bool createCommunicationHistory = true)
{
try
{
List <Person> personList = null;
Guid adminGroup = Rock.SystemGuid.Group.GROUP_ADMINISTRATORS.AsGuid();
using (var rockContext = new RockContext())
{
personList = new GroupMemberService(rockContext).Queryable()
.Where(m =>
m.Group.Guid.Equals(adminGroup) &&
m.GroupMemberStatus == GroupMemberStatus.Active &&
m.Person.Email != null &&
m.Person.Email != "")
.Select(m => m.Person)
.ToList();
}
var errorMessages = new List <string>();
var recipients = personList.Select(a => new RockEmailMessageRecipient(a, null)).ToList();
var emailMessage = new RockEmailMessage();
emailMessage.FromEmail = GlobalAttributesCache.Value("OrganizationEmail");
emailMessage.Subject = subject;
emailMessage.SetRecipients(recipients);
emailMessage.Message = message;
emailMessage.ThemeRoot = themeRoot;
emailMessage.AppRoot = appRoot;
emailMessage.CreateCommunicationRecord = createCommunicationHistory;
emailMessage.Send(out errorMessages);
}
catch (Exception ex)
{
ExceptionLogService.LogException(ex, HttpContext.Current);
}
}
private RockEmailMessage GetRecipientRockEmailMessage(RockEmailMessage emailMessage, Model.Communication communication, CommunicationRecipient communicationRecipient, Dictionary <string, object> mergeFields, string organizationEmail, Dictionary <string, string> mediumAttributes)
{
var recipientEmail = new RockEmailMessage();
recipientEmail.CurrentPerson = emailMessage.CurrentPerson;
recipientEmail.EnabledLavaCommands = emailMessage.EnabledLavaCommands;
recipientEmail.AppRoot = emailMessage.AppRoot;
recipientEmail.CssInliningEnabled = emailMessage.CssInliningEnabled;
// CC
if (communication.CCEmails.IsNotNullOrWhiteSpace())
{
string[] ccRecipients = communication
.CCEmails
.ResolveMergeFields(mergeFields, emailMessage.CurrentPerson)
.Replace(";", ",")
.Split(',');
foreach (var ccRecipient in ccRecipients)
{
recipientEmail.CCEmails.Add(ccRecipient);
}
}
// BCC
if (communication.BCCEmails.IsNotNullOrWhiteSpace())
{
string[] bccRecipients = communication
.BCCEmails
.ResolveMergeFields(mergeFields, emailMessage.CurrentPerson)
.Replace(";", ",")
.Split(',');
foreach (var bccRecipient in bccRecipients)
{
recipientEmail.BCCEmails.Add(bccRecipient);
}
}
// Attachments
recipientEmail.Attachments = emailMessage.Attachments;
// Communication record for tracking opens & clicks
recipientEmail.MessageMetaData = new Dictionary <string, string>(emailMessage.MessageMetaData);
// To
var toEmailAddress = new RockEmailMessageRecipient(null, null)
{
To = communicationRecipient.PersonAlias.Person.Email,
Name = communicationRecipient.PersonAlias.Person.FullName
};
recipientEmail.SetRecipients(new List <RockEmailMessageRecipient> {
toEmailAddress
});
var fromMailAddress = new MailAddress(emailMessage.FromEmail, emailMessage.FromName);
var checkResult = CheckSafeSender(new List <string> {
toEmailAddress.EmailAddress
}, fromMailAddress, organizationEmail);
// Reply To
recipientEmail.ReplyToEmail = GetRecipientReplyToAddress(emailMessage, mergeFields, checkResult);
// From
if (checkResult.IsUnsafeDomain && checkResult.SafeFromAddress != null)
{
recipientEmail.FromName = checkResult.SafeFromAddress.DisplayName;
recipientEmail.FromEmail = checkResult.SafeFromAddress.Address;
}
else
{
recipientEmail.FromName = fromMailAddress.DisplayName;
recipientEmail.FromEmail = fromMailAddress.Address;
}
// Subject
var subject = ResolveText(communication.Subject, emailMessage.CurrentPerson, communication.EnabledLavaCommands, mergeFields, emailMessage.AppRoot);
recipientEmail.Subject = subject;
// Body Plain Text
if (mediumAttributes.ContainsKey("DefaultPlainText"))
{
var plainText = ResolveText(mediumAttributes["DefaultPlainText"],
emailMessage.CurrentPerson,
communication.EnabledLavaCommands,
mergeFields,
emailMessage.AppRoot);
if (!string.IsNullOrWhiteSpace(plainText))
{
recipientEmail.PlainTextMessage = plainText;
}
}
// Body (HTML)
string htmlBody = communication.Message;
// Get the unsubscribe content and add a merge field for it
if (communication.IsBulkCommunication && mediumAttributes.ContainsKey("UnsubscribeHTML"))
{
string unsubscribeHtml = ResolveText(mediumAttributes["UnsubscribeHTML"],
emailMessage.CurrentPerson,
communication.EnabledLavaCommands,
mergeFields,
emailMessage.AppRoot);
mergeFields.AddOrReplace("UnsubscribeOption", unsubscribeHtml);
htmlBody = ResolveText(htmlBody, emailMessage.CurrentPerson, communication.EnabledLavaCommands, mergeFields, emailMessage.AppRoot);
// Resolve special syntax needed if option was included in global attribute
if (Regex.IsMatch(htmlBody, @"\[\[\s*UnsubscribeOption\s*\]\]"))
{
htmlBody = Regex.Replace(htmlBody, @"\[\[\s*UnsubscribeOption\s*\]\]", unsubscribeHtml);
}
// Add the unsubscribe option at end if it wasn't included in content
if (!htmlBody.Contains(unsubscribeHtml))
{
htmlBody += unsubscribeHtml;
}
}
else
{
htmlBody = ResolveText(htmlBody, emailMessage.CurrentPerson, communication.EnabledLavaCommands, mergeFields, emailMessage.AppRoot);
htmlBody = Regex.Replace(htmlBody, @"\[\[\s*UnsubscribeOption\s*\]\]", string.Empty);
}
if (!string.IsNullOrWhiteSpace(htmlBody))
{
if (emailMessage.CssInliningEnabled)
{
// move styles inline to help it be compatible with more email clients
htmlBody = htmlBody.ConvertHtmlStylesToInlineAttributes();
}
// add the main Html content to the email
recipientEmail.Message = htmlBody;
}
recipientEmail.MessageMetaData["communication_recipient_guid"] = communicationRecipient.Guid.ToString();
return(recipientEmail);
}
private RockEmailMessage GetRecipientRockEmailMessage(RockEmailMessage emailMessage, RockMessageRecipient rockMessageRecipient, Dictionary <string, object> mergeFields, string organizationEmail)
{
var recipientEmail = new RockEmailMessage();
recipientEmail.CurrentPerson = emailMessage.CurrentPerson;
recipientEmail.EnabledLavaCommands = emailMessage.EnabledLavaCommands;
recipientEmail.AppRoot = emailMessage.AppRoot;
recipientEmail.CssInliningEnabled = emailMessage.CssInliningEnabled;
// CC
recipientEmail.CCEmails = emailMessage.CCEmails;
// BCC
recipientEmail.BCCEmails = emailMessage.BCCEmails;
// Attachments
recipientEmail.Attachments = emailMessage.Attachments;
// Communication record for tracking opens & clicks
recipientEmail.MessageMetaData = new Dictionary <string, string>(emailMessage.MessageMetaData);
foreach (var mergeField in mergeFields)
{
rockMessageRecipient.MergeFields.AddOrIgnore(mergeField.Key, mergeField.Value);
}
// To
var toEmailAddress = new RockEmailMessageRecipient(null, null)
{
To = rockMessageRecipient
.To
.ResolveMergeFields(rockMessageRecipient.MergeFields, emailMessage.CurrentPerson, emailMessage.EnabledLavaCommands),
Name = rockMessageRecipient
.Name
.ResolveMergeFields(rockMessageRecipient.MergeFields, emailMessage.CurrentPerson, emailMessage.EnabledLavaCommands)
};
recipientEmail.SetRecipients(new List <RockEmailMessageRecipient> {
toEmailAddress
});
var fromMailAddress = new MailAddress(emailMessage.FromEmail, emailMessage.FromName);
var checkResult = CheckSafeSender(new List <string> {
toEmailAddress.EmailAddress
}, fromMailAddress, organizationEmail);
// Reply To
recipientEmail.ReplyToEmail = GetRecipientReplyToAddress(emailMessage, mergeFields, checkResult);
// From
if (checkResult.IsUnsafeDomain && checkResult.SafeFromAddress != null)
{
recipientEmail.FromName = checkResult.SafeFromAddress.DisplayName;
recipientEmail.FromEmail = checkResult.SafeFromAddress.Address;
}
else
{
recipientEmail.FromName = fromMailAddress.DisplayName;
recipientEmail.FromEmail = fromMailAddress.Address;
}
// Subject
string subject = ResolveText(emailMessage.Subject, emailMessage.CurrentPerson, emailMessage.EnabledLavaCommands, rockMessageRecipient.MergeFields, emailMessage.AppRoot, emailMessage.ThemeRoot).Left(998);
recipientEmail.Subject = subject;
// Plain Text Message
recipientEmail.PlainTextMessage = ResolveText(emailMessage.PlainTextMessage, emailMessage.CurrentPerson, emailMessage.EnabledLavaCommands, rockMessageRecipient.MergeFields, emailMessage.AppRoot, emailMessage.ThemeRoot);
// Body (HTML)
string body = ResolveText(emailMessage.Message, emailMessage.CurrentPerson, emailMessage.EnabledLavaCommands, rockMessageRecipient.MergeFields, emailMessage.AppRoot, emailMessage.ThemeRoot);
body = Regex.Replace(body, @"\[\[\s*UnsubscribeOption\s*\]\]", string.Empty);
recipientEmail.Message = body;
Guid?recipientGuid = null;
recipientEmail.CreateCommunicationRecord = emailMessage.CreateCommunicationRecord;
if (emailMessage.CreateCommunicationRecord)
{
recipientGuid = Guid.NewGuid();
recipientEmail.MessageMetaData["communication_recipient_guid"] = recipientGuid.ToString();
}
return(recipientEmail);
}