Support both Text & HTML in the same email

src/OrchardCore.Modules/OrchardCore.Email.Azure/Services/AzureEmailProviderBase.cs

@@ -178,15 +178,11 @@ private EmailMessage FromMailMessage(MailMessage message, Dictionary<string, ILi
             bccRecipients = [.. recipients.Bcc.Select(r => new EmailAddress(r))];
         }
 
-        var content = new EmailContent(message.Subject);
-        if (message.IsHtmlBody)
+        var content = new EmailContent(message.Subject)
         {
-            content.Html = message.Body;
-        }
-        else
-        {
-            content.PlainText = message.Body;
-        }
+            PlainText = message.Body?.Text,
+            Html = message.Body?.Html
+        };
 
         var emailMessage = new EmailMessage(
             message.From,

src/OrchardCore.Modules/OrchardCore.Email.Smtp/Services/SmtpEmailProviderBase.cs

@@ -113,16 +113,11 @@ private MimeMessage GetMimeMessage(MailMessage message)
 
         mimeMessage.Subject = message.Subject;
 
-        var body = new BodyBuilder();
-
-        if (message.IsHtmlBody)
-        {
-            body.HtmlBody = message.Body;
-        }
-        else
+        var body = new BodyBuilder
         {
-            body.TextBody = message.Body;
-        }
+            TextBody = message.Body?.Text,
+            HtmlBody = message.Body?.Html
+        };
 
         foreach (var attachment in message.Attachments)
         {

src/OrchardCore.Modules/OrchardCore.Email/Controllers/AdminController.cs

@@ -134,7 +134,7 @@ private static MailMessage GetMessage(EmailTestViewModel testSettings)
 
         if (!string.IsNullOrWhiteSpace(testSettings.Body))
         {
-            message.Body = testSettings.Body;
+            message.Body = new MailMessageBody { Text = testSettings.Body };
         }
 
         return message;

src/OrchardCore.Modules/OrchardCore.Email/Views/Items/EmailTask.Fields.Edit.cshtml

@@ -1,5 +1,14 @@
 @using OrchardCore.Email.Workflows.ViewModels
 @model EmailTaskViewModel
+@functions
+{
+    private enum MailMessageFormat
+    {
+        Text,
+        Html,
+        All
+    }
+}
 
 <div class="mb-3" asp-validation-class-for="AuthorExpression">
     <label asp-for="AuthorExpression" class="form-label">@T["From"]</label>
@@ -51,17 +60,25 @@
 </div>
 
 <div class="mb-3">
-    <div class="form-check">
-        <input type="checkbox" class="form-check-input" asp-for="IsHtmlBody" />
-        <label class="form-check-label" asp-for="IsHtmlBody">@T["Does the Body contain HTML?"]</label>
-        <span class="hint dashed">@T["If checked, indicates the body of the email message will be sent as HTML."]</span>
-    </div>
+    <label>@T["Format"]</label>
+    <select class="form-select">
+        <option value="@MailMessageFormat.Text">@nameof(MailMessageFormat.Text)</option>
+        <option value="@MailMessageFormat.Html">@nameof(MailMessageFormat.Html)</option>
+        <option value="@MailMessageFormat.All">@nameof(MailMessageFormat.All)</option>
+    </select>
+    <span class="hint">@T["The format of the email message."]</span>
 </div>
 
-<div class="mb-3" id="body">
-    <label asp-for="Body" class="form-label">@T["Body"]</label>
-    <textarea asp-for="Body" rows="5" class="form-control"></textarea>
-    <span class="hint">@T["The body of the email message. With Liquid support."]</span>
+<div class="mb-3" id="textBody">
+    <label asp-for="TextBody">@T["Text Body"]</label>
+    <textarea asp-for="TextBody" rows="5" class="form-control"></textarea>
+    <span class="hint">@T["The plain text body of the email message. With Liquid support."]</span>
+</div>
+
+<div class="mb-3 d-none" id="htmlBody">
+    <label asp-for="HtmlBody">@T["HTML Body"]</label>
+    <textarea asp-for="HtmlBody" rows="5" class="form-control"></textarea>
+    <span class="hint">@T["The HTML body of the email message. With Liquid support."]</span>
 </div>
 
 <style asp-name="codemirror"></style>
@@ -73,12 +90,36 @@
 <script asp-src="~/OrchardCore.Liquid/codemirror/liquid.js" at="Foot"></script>
 
 <script at="Foot">
-$(function () {
-    var bodyEditor = CodeMirror.fromTextArea(document.getElementById('@Html.IdFor(x => x.Body)'), {
-        lineNumbers: true,
-        styleActiveLine: true,
-        matchBrackets: true,
-        mode: { name: "liquid" },
+    $(function () {
+        var textBodyEditor = CodeMirror.fromTextArea(document.getElementById('@Html.IdFor(x => x.TextBody)'), {
+            lineNumbers: true,
+            styleActiveLine: true,
+            matchBrackets: true,
+            mode: { name: "liquid" },
+        });
+        var htmlBodyEditor = CodeMirror.fromTextArea(document.getElementById('@Html.IdFor(x => x.HtmlBody)'), {
+            lineNumbers: true,
+            styleActiveLine: true,
+            matchBrackets: true,
+            mode: { name: "liquid" },
+        });
+
+        $('select').onchange(function () {
+            var selectedValue = $(this).val();
+            switch (selectedValue) {
+                case '@MailMessageFormat.Text':
+                    $('#textBody').removeClass('d-none');
+                    $('#htmlBody').addClass('d-none');
+                    break;
+                case '@MailMessageFormat.Html':
+                    $('#textBody').removeClass('d-none');
+                    $('#htmlBody').addClass('d-none');
+                    break;
+                case '@MailMessageFormat.All':
+                    $('#textBody').removeClass('d-none');
+                    $('#htmlBody').removeClass('d-none');
+                    break;
+            }
+        });
     });
-});
 </script>

src/OrchardCore.Modules/OrchardCore.Email/Workflows/Activities/EmailTask.cs

@@ -76,15 +76,15 @@ public WorkflowExpression<string> Subject
             set => SetProperty(value);
         }
 
-        public WorkflowExpression<string> Body
+        public WorkflowExpression<string> TextBody
         {
             get => GetProperty(() => new WorkflowExpression<string>());
             set => SetProperty(value);
         }
 
-        public bool IsHtmlBody
+        public WorkflowExpression<string> HtmlBody
         {
-            get => GetProperty(() => true);
+            get => GetProperty(() => new WorkflowExpression<string>());
             set => SetProperty(value);
         }
 
@@ -102,7 +102,8 @@ public override async Task<ActivityExecutionResult> ExecuteAsync(WorkflowExecuti
             var cc = await _expressionEvaluator.EvaluateAsync(Cc, workflowContext, null);
             var bcc = await _expressionEvaluator.EvaluateAsync(Bcc, workflowContext, null);
             var subject = await _expressionEvaluator.EvaluateAsync(Subject, workflowContext, null);
-            var body = await _expressionEvaluator.EvaluateAsync(Body, workflowContext, IsHtmlBody ? _htmlEncoder : null);
+            var textBody = await _expressionEvaluator.EvaluateAsync(TextBody, workflowContext, null);
+            var htmlBody = await _expressionEvaluator.EvaluateAsync(HtmlBody, workflowContext, _htmlEncoder);
 
             var message = new MailMessage
             {
@@ -114,8 +115,11 @@ public override async Task<ActivityExecutionResult> ExecuteAsync(WorkflowExecuti
                 // Email reply-to header https://tools.ietf.org/html/rfc4021#section-2.1.4
                 ReplyTo = replyTo?.Trim(),
                 Subject = subject?.Trim(),
-                Body = body?.Trim(),
-                IsHtmlBody = IsHtmlBody
+                Body = new MailMessageBody
+                {
+                    Text = textBody?.Trim(),
+                    Html = htmlBody?.Trim()
+                }
             };
 
             if (!string.IsNullOrWhiteSpace(sender))

src/OrchardCore.Modules/OrchardCore.Email/Workflows/Drivers/EmailTaskDisplayDriver.cs

@@ -14,8 +14,8 @@ protected override void EditActivity(EmailTask activity, EmailTaskViewModel mode
             model.RecipientsExpression = activity.Recipients.Expression;
             model.ReplyToExpression = activity.ReplyTo.Expression;
             model.SubjectExpression = activity.Subject.Expression;
-            model.Body = activity.Body.Expression;
-            model.IsHtmlBody = activity.IsHtmlBody;
+            model.TextBody = activity.TextBody.Expression;
+            model.HtmlBody = activity.HtmlBody.Expression;
             model.BccExpression = activity.Bcc.Expression;
             model.CcExpression = activity.Cc.Expression;
         }
@@ -27,8 +27,8 @@ protected override void UpdateActivity(EmailTaskViewModel model, EmailTask activ
             activity.Recipients = new WorkflowExpression<string>(model.RecipientsExpression);
             activity.ReplyTo = new WorkflowExpression<string>(model.ReplyToExpression);
             activity.Subject = new WorkflowExpression<string>(model.SubjectExpression);
-            activity.Body = new WorkflowExpression<string>(model.Body);
-            activity.IsHtmlBody = model.IsHtmlBody;
+            activity.TextBody = new WorkflowExpression<string>(model.TextBody);
+            activity.HtmlBody = new WorkflowExpression<string>(model.HtmlBody);
             activity.Bcc = new WorkflowExpression<string>(model.BccExpression);
             activity.Cc = new WorkflowExpression<string>(model.CcExpression);
         }

src/OrchardCore.Modules/OrchardCore.Email/Workflows/ViewModels/EmailTaskViewModel.cs

@@ -16,8 +16,8 @@ public class EmailTaskViewModel
 
         public string SubjectExpression { get; set; }
 
-        public string Body { get; set; }
+        public string TextBody { get; set; }
 
-        public bool IsHtmlBody { get; set; }
+        public string HtmlBody { get; set; }
     }
 }

src/OrchardCore.Modules/OrchardCore.Users/Controllers/ControllerExtensions.cs

@@ -38,8 +38,7 @@ internal static async Task<bool> SendEmailAsync(this Controller controller, stri
             {
                 To = email,
                 Subject = subject,
-                Body = body,
-                IsHtmlBody = true
+                Body = new MailMessageBody { Html = body }
             };
 
             var result = await emailService.SendAsync(message);

src/OrchardCore.Modules/OrchardCore.Users/Controllers/EmailAuthenticatorController.cs

@@ -101,8 +101,10 @@ public async Task<IActionResult> RequestCode()
         {
             To = await UserManager.GetEmailAsync(user),
             Subject = await GetSubjectAsync(settings, user, code),
-            Body = await GetBodyAsync(settings, user, code),
-            IsHtmlBody = true,
+            Body = new MailMessageBody
+            {
+                Html = await GetBodyAsync(settings, user, code)
+            }
         };
 
         var result = await _emailService.SendAsync(message);
@@ -174,8 +176,10 @@ public async Task<IActionResult> SendCode()
         {
             To = await UserManager.GetEmailAsync(user),
             Subject = await GetSubjectAsync(settings, user, code),
-            Body = await GetBodyAsync(settings, user, code),
-            IsHtmlBody = true,
+            Body = new MailMessageBody
+            {
+                Html = await GetBodyAsync(settings, user, code)
+            }
         };
 
         var result = await _emailService.SendAsync(message);

src/OrchardCore.Modules/OrchardCore.Users/Workflows/Activities/RegisterUserTask.cs

@@ -136,12 +136,11 @@ public override async Task<ActivityExecutionResult> ExecuteAsync(WorkflowExecuti
 
                     var body = await _expressionEvaluator.EvaluateAsync(ConfirmationEmailTemplate, workflowContext, _htmlEncoder);
 
-                    var message = new MailMessage()
+                    var message = new MailMessage
                     {
                         To = email,
                         Subject = subject,
-                        Body = body,
-                        IsHtmlBody = true
+                        Body = new MailMessageBody { Html = body }
                     };
 
                     var result = await _emailService.SendAsync(message);

src/OrchardCore/OrchardCore.Email.Abstractions/MailMessage.cs

@@ -1,4 +1,3 @@
-using System;
 using System.Collections.Generic;
 
 namespace OrchardCore.Email
@@ -49,47 +48,7 @@ public class MailMessage
         /// <summary>
         /// Gets or sets the message content aka body.
         /// </summary>
-        /// <remarks>This property is work in conjunction with <see cref="IsHtmlBody"/> to determine the body type..</remarks>
-        public string Body { get; set; }
-
-        /// <summary>
-        /// Gets or sets the message content as plain text.
-        /// </summary>
-        [Obsolete("This property is deprecated, please use Body instead.")]
-        public string BodyText
-        {
-            get => Body;
-            set
-            {
-                Body = value;
-                IsHtmlBody = false;
-            }
-        }
-
-        /// <summary>
-        /// Gets or sets whether the message body is an HTML.
-        /// </summary>
-        [Obsolete("This property is deprecated, please use IsHtmlBody instead.")]
-        public bool IsBodyHtml
-        {
-            get => IsHtmlBody;
-            set => IsHtmlBody = value;
-        }
-
-        /// <summary>
-        /// Gets or sets whether the message body is plain text.
-        /// </summary>
-        [Obsolete("This property is deprecated, please use IsHtmlBody instead.")]
-        public bool IsBodyText
-        {
-            get => !IsHtmlBody;
-            set => IsHtmlBody = !value;
-        }
-
-        /// <summary>
-        /// Gets or sets whether the message body is an HTML or not. Default is <c>false</c> which is plain text.
-        /// </summary>
-        public bool IsHtmlBody { get; set; }
+        public MailMessageBody Body { get; set; }
 
         /// <summary>
         /// The collection of message attachments.

src/OrchardCore/OrchardCore.Email.Abstractions/MailMessageBody.cs

@@ -0,0 +1,17 @@
+namespace OrchardCore.Email;
+
+/// <summary>
+/// Represents a body for <see cref="MailMessage"/>.
+/// </summary>
+public class MailMessageBody
+{
+    /// <summary>
+    /// Gets or sets the body in plain text format.
+    /// </summary>
+    public string Text { get; set; }
+
+    /// <summary>
+    /// Gets or sets the body in HTML format.
+    /// </summary>
+    public string Html { get; set; }
+}

src/OrchardCore/OrchardCore.Notifications.Core/Services/EmailNotificationProvider.cs

@@ -35,17 +35,15 @@ public async Task<bool> TrySendAsync(object notify, INotificationMessage message
         {
             To = user.Email,
             Subject = message.Summary,
+            Body = new MailMessageBody()
         };
-
         if (message.IsHtmlPreferred && !string.IsNullOrWhiteSpace(message.HtmlBody))
         {
-            mailMessage.Body = message.HtmlBody;
-            mailMessage.IsHtmlBody = true;
+            mailMessage.Body.Html = message.HtmlBody;
         }
         else
         {
-            mailMessage.Body = message.TextBody;
-            mailMessage.IsHtmlBody = false;
+            mailMessage.Body.Text = message.TextBody;
         }
 
         var result = await _emailService.SendAsync(mailMessage);

src/docs/releases/1.8.0.md

@@ -12,6 +12,10 @@ The interface `OrchardCore.Documents.IDocumentSerialiser` has been renamed to `O
 
 This release removes support for `net6.0` and `net7.0`. Only `net8.0` is supported.
 
+### Email
+
+The `MailMessage.Body` now returns `MailMessageBody` instead of `string` to support both plain text & HTML formats.
+
 ### TheAdmin Theme
 
 The `TheAdmin` theme was upgraded to Bootstrap 5.3.2. Here is a list of the breaking changes

src/docs/releases/1.9.0.md

@@ -70,6 +70,10 @@ Additionally, if you need to enable indexing for text file with `.txt`, `.md` ex
 
 If you need to enable indexing for other extensions like (`.docx`, or `.pptx`), you will need the `OrchardCore.Media.Indexing.OpenXML` feature.
 
+### Email Module
+
+In the past, we use `Body` and `BodyText` to distinguish between the `MailMessage` body format, in this release `MailMessageBody` has been used instead.
+
 ### SMS Module
 
 In the past, we utilized the injection of `ISmsProvider` for sending SMS messages. However, in this release, it is now necessary to inject `ISmsService` instead.