EmailService.cs

// <copyright file="EmailService.cs" company="Engage Software">
// Engage: Tell-A-Friend
// Copyright (c) 2004-2013
// by Engage Software ( http://www.engagesoftware.com )
// </copyright>
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED 
// TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF 
// CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
// DEALINGS IN THE SOFTWARE.

namespace Engage.Dnn.TellAFriend
{
    using System.Text;
    using System.Web;

    using DotNetNuke.Entities.Host;
    using DotNetNuke.Entities.Modules;
    using DotNetNuke.Services.Localization;
    using DotNetNuke.Services.Mail;

    /// <summary>Service to send the email</summary>
    public static class EmailService
    {
        /// <summary>Sends the email.</summary>
        /// <param name="localResourceFile">The local resource file.</param>
        /// <param name="siteUrl">The site URL.</param>
        /// <param name="portalName">Name of the portal.</param>
        /// <param name="senderEmail">The sender email.</param>
        /// <param name="friendsEmail">The friends email.</param>
        /// <param name="senderName">Name of the sender.</param>
        /// <param name="friendName">Name of the friend.</param>
        /// <param name="message">The message.</param>
        /// <param name="portalEmail">The portal administrator's email.</param>
        /// <param name="moduleId">The ID of the module from which this email is being sent.</param>
        /// <param name="tabId">The ID of the tab from which this email is being sent.</param>
        /// <returns>The result of the SendEmail method.</returns>
        public static string SendEmail(string localResourceFile, string siteUrl, string portalName, string senderEmail, string friendsEmail, string senderName, string friendName, string message, string portalEmail, int moduleId, int tabId)
        {
            using (var settingsControl = new Settings())
            {
                settingsControl.ModuleConfiguration = new ModuleController().GetModule(moduleId, tabId);

                var from = Utility.GetStringSetting(settingsControl.Settings, "From", string.Empty);
                var carbonCopy = Utility.GetStringSetting(settingsControl.Settings, "CarbonCopy", string.Empty);
                var blindCarbonCopy = Utility.GetStringSetting(settingsControl.Settings, "BlindCarbonCopy", string.Empty);

                var body = Utility.GetStringSetting(settingsControl.Settings, "Body", Localization.GetString("EmailAFriend", localResourceFile));
                var subject = Utility.GetStringSetting(settingsControl.Settings, "Subject", Localization.GetString("EmailAFriendSubject", localResourceFile));

                body = ReplaceTokens(body, friendName, siteUrl, senderName, message, portalName, senderEmail, true);
                subject = ReplaceTokens(subject, friendName, siteUrl, senderName, message, portalName, senderEmail, false);

                return Mail.SendMail(
                    !string.IsNullOrEmpty(from) ? from : portalEmail,
                    friendsEmail,
                    carbonCopy,
                    blindCarbonCopy,
                    senderEmail,
                    MailPriority.Normal,
                    subject,
                    MailFormat.Html,
                    Encoding.UTF8,
                    body,
                    new string[0],
                    string.Empty,
                    string.Empty,
                    string.Empty,
                    string.Empty,
                    Host.EnableSMTPSSL);
            }
        }

        /// <summary>Replaces the tokens in the given <paramref name="tokenizedText" />.</summary>
        /// <param name="tokenizedText">Text with tokens to be replaced</param>
        /// <param name="friendName">Name of the friend, replaces <c>[Engage:Recipient]</c>.</param>
        /// <param name="siteUrl">The site URL, replaces <c>[Engage:Url]</c>.</param>
        /// <param name="senderName">Name of the sender, replaces <c>[Engage:From]</c>.</param>
        /// <param name="message">The message, replaces <c>[Engage:Message]</c>.</param>
        /// <param name="portalName">Name of the portal, replaces <c>[Engage:Portal]</c>.</param>
        /// <param name="senderEmail">The sender's email.</param>
        /// <param name="encode">Specifies if the replaced tokens should be encoded.</param>
        /// <returns>The string with the given tokens replaced</returns>
        private static string ReplaceTokens(string tokenizedText, string friendName, string siteUrl, string senderName, string message, string portalName, string senderEmail, bool encode)
        {
            return new StringBuilder(tokenizedText)
                .Replace("[Engage:Recipient]", encode ? HttpUtility.HtmlEncode(friendName) : friendName)
                .Replace("[Engage:Url]", encode ? HttpUtility.HtmlEncode(siteUrl) : siteUrl)
                .Replace("[Engage:From]", encode ? HttpUtility.HtmlEncode(senderName) : senderName)
                .Replace("[Engage:Message]", encode ? HttpUtility.HtmlEncode(message).Replace("\n", "<br />") : message)
                .Replace("[Engage:Portal]", encode ? HttpUtility.HtmlEncode(portalName) : portalName)
                .Replace("[Engage:SenderEmail]", encode ? HttpUtility.HtmlEncode(senderEmail) : senderEmail)
                .ToString();
        }
    }
}