MailChemist.Core 1.0.3

MailChemist

MailChemist is a combination of two technologies (MJML, and Fluid.NET) to dynamically generate beautiful responsive emails driven by templates.

Content Providers

An email content provider is a high-level class that handles preparing the email template content for fluid Generater using e.g. Web API, file and SQL. Currently MailChemist supports two content providers:

• MJML API
• File

Getting started

Basic usage example

Basic usage using the MJML API and Fluid using an anonymous model.

var model = new 
{
    FirstName = "Paul"
};

string content = @"<mjml><mj-body>{{ Model.FirstName }}</mj-body></mjml>";

var mailChemist = new MailChemist("YourMjmlAppId", "YourMjmlSecretKey");
mailChemist.TryGenerate(content, model, out var result, out var errors, true);

RegisterType is required to be set to true since it's an anonymous type. This should be set to false, if you intend on using the MailChemistModel attribute which would be cached.

Usage without having to register the type each call

[MailChemistModel]
public class PersonModel
{
    public string FirstName { get; set; }

    public string LastName { get; set; }
}

If your using nested types, you will need to decorate them with MailChemistModel too.

You will only need to call MailChemist.RegisterGlobalTypes() once before calling TryGenerateFluid() or TryGenerate().

Usage using file content provider

If you want a higher performance by using already Generated MJML you can use the FileEmailContentProvider without the overhead of connecting to an external website to Generate the MJML.

var mailChemist = new MailChemist(new FileEmailContentProvider("Templates"));

mailChemist.TryGenerate("Test.mc", model, out var result, out var errors, true);

Test.mc would contain the pre-Generated MJML with Fluid.NET templating.

Fluid.NET Filters

MailChemist utilises Fluid.NET under the hood because of this; You can leverage custom filter functions in your templates. MailChemist has out of the box fluid filters which can be registered by running MailChemist.RegisterGlobalFilters().

IsLessThanZeroAddClassFilter

IsLessThanZeroAddClassFilter can be used like:

<div class="{{ Model.Profit | IsLessThanZeroAddClass:'redText' }}">{{ Model.Profit }}</div>

If Profit was lower than zero then it would generate:

<div class="redText">-1</div>

Appreciations

Thanks to the following great projects that made MailChemist possible:

• Fluid.NET
• MJML