Finally, after a lot of hard work - the Newsletter Studio 3 for Umbraco 8 is out!

Looking for Umbraco 9? Have a look here.

A total rewrite

The new version is a total rewrite for Umbraco 8, we have tried to be smart about this so that we can make the move to Umbraco vNext (based on .NET 5).


The beta version should be fully functional, almost all features from version 2 is included along with a lot of new and existing features. It would take hours to go through all of them, but this is a brief summery of the most important news.

Responsive Email Editor

The old "Rich Text Editor" used to create emails in version 2 is long gone and replaced with an editor that makes it super easy to create responsive emails with high resolution images that renders nice in all desktop and mobile clients.

The editor is configurable with custom themes that controls default colors, fonts, sizes etc. It's also possible to extend many parts of the editor ie. adding custom Email Controls (like Image, Text, Button) and create "Merge Field Providers" that lists valid Fields for the editor to insert.

The rendering of the email is done using razor templates, one "main template" for the rows and columns and one template for each Control, all of these can be customized in a custom theme if needed.

 

The new email editor


Preview-feature for both desktop and mobile

Transactional Emails

While this is not included in beta the addition of transactional email will be a huge improvement for the package. Developers can create C# models with property attributes that makes it possible to show the class-properties and options as Fields inside the email editor. The possibilities with this are endless but most obvious examples is welcome emails, forgot password emails, signup confirmations etc.

 

Multi-Tenant support

The new version is built around a optional multi-tenant foundation. Each installation will have at least one "Workspace". Each Workspace is an independent "entity" that has it's own recipients, mailing lists, themes and settings. Workspaces comes with granular permissions that can be mapped to User Groups or individual Users. 

Using multiple Workspaces comes with additional charges for the license, see the pricing page for details.

Email Service Providers

SMTP is still the way to send emails but these days there's a lot of great Email API services available. In Newsletter Studio 3 the process of sending the email is abstracted so that it's quite easy to implement an "Email Service Provider" that can talk to what ever API we want ie. Mandrill, SendGrid, MailJet or MailGun. This make it possible to skip the slow SMTP-protocol and send via API if wanted.

Improved Recipient Details view

A fundamental changed in v3 compared to v2 is that each Workspace only stores a Recipient once and creates relations between a Mailing List and the Recipient. This makes it possible to create a nice view with details about each Recipient.

 

 

Install using NuGet

We've made the package available on NuGet:

Install-Package NewsletterStudio


https://www.nuget.org/packages/NewsletterStudio/ 

 

Install as Umbraco Package

There is also a Umbraco Package that can be installed via the Backoffice of Umbraco, just go to our page on our.umbraco.org to download the package.

 

Documentation

Once you've installed the package, take some time to look at the documentation.

 

Known issues and feedback

At the moment there is no known issues with the package. Please feel free to reach out with questions and feedback to info@newsletterstudio.org.

 

Release notes for Beta/RC-versions

4.0.0-rc1 - Released 2021-11-07

We're releasing the first RC for Umbraco 9!

This version has the exact same features as version 3.0.0. 

Install via NuGet and don't forget to check "Include Prerelease" to see the v4-version in the list.

 

3.0.0 - Released 2021-11-07

The first stable release of Newsletter Studio for Umbraco 8 is out!

Due to the alignment with the Umbraco 9-version we had to make some last minute breaking changes. This is mostly around the INewlsetterStudio-service and the Request-objects passed into the service.

Summary:

Significant changes:

  • Adjusted fluent API for INewsletterStudio-request objects

Fixes:

  • Fixes SignalR-communication
  • Added AppSetting for Content App content types.
  • Added default theme for email rendering is theme is not selected
  • Added missing translations
  • Fix to import recipients file upload

RC 1 - Released 2021-10-24

Moved in to RC, this release is to consider as close as possible to the first stable release. 

Summary:

Significant changes:

  • Adds bounce handling for SMTP
  • Adds support for "double opt in" using transactional template.
  • Translations fixed of about 98% of the views, some parts of the license-handling in the administration-UI will not be multi-language.
  • Stabilizes the IEmailServiceProvider-interface for integrations with email senders (sending with SMTP or API-services) 
    • Added property "ExternalId" for sent emails to use for follow up in IEmailServiceProvider
    • Added methodd for background-jobs inside provider, used for handling errors and bounces.
  • Extended validation before sending emails, also validating Workspace-settings.

Fixes:

  • Fixes issue with tinymce-plugin-file not being loaded.
  • Fixes issue with empty a-hrefs throwing exceptions
  • Adds property for PreviewText for transactional email sending API.
  • Fixes css-issue for button fonts in template.
  • Support for fragments / hashbangs in URLs
  • Fixes issue with unsubscribe-confirmation when site forces trailing slash with 301-redirects.
  • Fixes issue in CssInliner with relative links to CSS-resources in custom templates.
  • Fixes sending-label in campaigns-list that was not automatically updated after sending completion
  • Fixes issue with built in ListProvider returning recipients with Pending-state to send out engine.
  • Fixes removing workspace also removes transactional email and tracking data for them.

 

Beta 8 - Released 2021-08-07

Just a patch-fix release for Beta7, fixes some minor issues. 

Summary:

  • Made tracking tokens smaller by reducing data
  • Remove test-code from Demo-Macro
  • Fixes issue with permissions (Workspaces without any permissions did not show up)
  • Unsubscribe works after Campaign has been removed

Beta 7 - Released 2021-08-06

A bigger release with the added support for Transactional e-emails to send emails from your system ie. "Welcome" emails and "Forgot Password" e-mails. All these can now be designed by editors in the backoffice. This feature can also be used in conjuction with ie. Umbraco Forms to send nicely designed email from the Forms. There is two videos to watch, the beta7 walkthrough and the UmbraCoffe-presentation.

Upgrading: Upgrade via NuGet or by uploading Umbraco Package. One might have to reset browser cache to refresh client files (js/css/html). Also might need to bump the "version" in /config/clientDependency.config to reset the backoffice client files cache.

Summary:

  • Added support for Transactional Emails (see the icon in the tree)
    • Create new Transactional Templates
    • Send via INewsletterStudioService
    • Use your own POCO-models for data
    • See statistical logs and view for each sent messages
    • Recipient timeline shows transactional emails and interactions
  • Breaking: Updated property/macro editor "Mailing List Picker" to support picking more than one list
  • Added property/macro editor "Transactional Email Picker"
  • Added preview-thumbnail in email listings
  • Added "Macro" Email Control to insert dynamic cshtml-files inside the email
  • Breaking: Updated IEmailControlType-interface, remove transactional-object from UpdateUniqueViewModel().
  • Reverted sorting for recipient lists, latest is now on top
  • Introduced new standard folder for extensions and global overrides. /App_Plugins/NewsletterStudioExtensions
  • Added Merge Fields to Link Picker (ie. using a Merge Field for button click URL)



Beta 6 - Released 2021-05-14

More polish, improvments and and bug fixes

Upgrading: Upgrade via NuGet or by uploading Umbraco Package. One might have to reset browser cache to refresh client files (js/css/html).

Summary:

  • (breaking) Namespace changes for models used in NewsletterStudioService
  • Improved log message on individual email-message when sending failed
  • UI-button fixes for disabled state
  • Import wizard tries to parse name from email when not explicitly provided
  • ContentApp: Populate workspace defaults for new messages
  • ContentApp: General improvements in validation and loading indicators
  • Fixes issues with save button shortcut being ctrl+c
  • Fixes issue with altTemplate alias for newsletter content templates
  • Workaround for Umbraco-bug with .tabbing-active and form fields taking up whole screen.


Beta 5 - Released 2021-04-24

Polish and fixes some issues related to newer Umbraco-versions.

Upgrading: Upgrade via NuGet or by uploading Umbraco Package. One might have to reset browser cache to refresh client files (js/css/html).

Summary:

  • Changed merge field format with support for fallbacks, new format: {{fieldAlias:"Fallback-text"}}
  • Fixes issue with local links that's not resolved in Rich Text Editor
  • Added report reloader for Campaign report (view in almost real time)
  • Fixes for sending progress indicator in dashboard
  • Polish for Campaign overview-listing.
  • Fixes db-scope issues for internal services 
  • Editor: Fixes issue where RTE stops updating the underlying model
  • Editor: Refactoring and polish for drag and drop. Auto select dropped email control.
  • Editor: Only show allowed controls in toolbox based on Workspace-settings
  • Tracking: Strip QueryStrings from URL-tracking.
  • INewsletterStudioService: Added support for setting status on subscriptions and method to add/update Subscriptions.

 

Beta 4 - Released 2021-04-11

Critical fix for sentDate for email tracking items, fixes some known issues and bugs found during beta testing.

Upgrading: Upgrade via NuGet or by uploading Umbraco Package. One might have to reset browser cache to refresh client files (js/css/html).

Summary:

  • NuGet: Moved DLLs to it's own NuGet-package (NewsletterStudio.Web). This means one can reference NewsletterStudio.Web when you don't want to include the clients-side files (App_Plugins).
  • Sending: Solved issue with "sentDate" on sent emails being set to wrong date.
  • Dashboard: Solved issue with "Sending progress" (SignalR)
  • Dashboard: Solved issue with chart for most recent campaign
  • UI: Tweaks and improvements for different Umbraco versions.
  • Recipient Details: "Dirty form"-warning when navigating away to timeline link.
  • Tracking: Added logic to avoid duplicates
  • Tracking: Graceful error handling if link data is corrupted.
  • Email Editor: Solved removed content throws JS-error.